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Section 1. Introduction 


Statement of Purpose 


DB2 includes a number of programming interfaces, some intended for general use 
and some that are product sensitive. We define those terms as follows: 


| General-Use Programming Interface 7 ] 


General-use programming interfaces are provided to allow you to write programs 
that use the services of IBM DATABASE 2. 


Meee oon os End of General-Use Programming Interface ee ee 
[ ss Product-Sensitive Programming Interface ] 


Installation exits and other product-sensitive interfaces are provided to allow you 
to perform tasks such as product tailoring, monitoring, modification, or diagnosis. 
They are dependent on the detailed design or implementation of the product. Such 
interfaces should be used only for those specialized purposes. Because of their 
dependencies on detailed design and implementation, it is to be expected that pro- 
grams written to such interfaces may need to be changed in order to run with new 
porduct releases or versions, or as a result of maintenance. 


a End of Product-Sensitive Programming Interface eee 


A definitive description of each interface is included in an appropriate place in the 
DB2 library, as shown in the table that follows. (All book titles begin with /BM 
DATABASE 2 Version 2.) 


interface Type Description is in... 

Structured Query Language (SQL), General use SQL Reference 

including SQLCA and SQLDA 

Call attachment facility General use Application Programming and SQL Guide 
SQL return codes Product-sensitive Messages and Codes 
Interfaces to user-written exit routines Product-sensitive Administration Guide 
Instrumentation facility interface (IF) Product-sensitive Administration Guide 
Commands used with IF Product-sensitive Command and Utility Reference 
DB2 catalog Product-sensitive SQL Reference 

DSNHDECP load module Product-sensitive DSNDDECP mapping macro 
RDI parameter list Product-sensitive DSNXRDI mapping macro 


This book is intended to help you to understand DB2 messages and codes. It pri- 
marily contains guidance information about the results of DB2 operations. Unless 
specifically stated otherwise, the information in this book must not be used for pro- 
gramming purposes. 
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However, this book also provides the following types of information, which are 
explicitly identified where they occur: 


e The SQL return codes are a product-sensitive programming interface. 


¢ The names of CSECTS that issue messages are internal DB2 information. 
Internal DB2 information is provided as additional guidance for diagnosing DB2. 
This internal information should never be used as programming interface infor- 
mation. 


References in this publication to IBM products, programs, or services do not imply 
that IBM intends to make these available in all countries in which IBM operates. 


Any references to an IBM licensed program or other IBM product in this publication 
is not intended to state or imply that only IBM’s program or other product may be 
used. Any functionally equivalent program may be used instead. 


IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Commercial Relations, IBM Corporation, Purchase, NY 10577. 


Trademarks and Service Marks 
The following term, used in the DB2 library, is a registered trademark or service 
mark of the IBM Corporation in the United States or other countries: 


IBM 


The following terms, used in the DB2 library, have been adopted by the IBM Corpo- 
ration as trademarks or service marks in the United States or other countries: 


DB2 MVS/XA SQL/DS 
DFSMS QBE System/370 
MVS/DFP QMF 3090 
MVS/ESA SAA 

About This Book 


Who This Book Is For 
This book, /BM DATABASE 2 Messages and Codes, lists messages and codes 
issued by DB2, with explanations and suggested responses. This book is intended 
for users and system programmers who might encounter DB2 messages and © 
codes. 


How This Book Is Organized 
“Section 1. Introduction” on page 1-1, explains the different types of messages and 
codes that DB2 generates. 


“Section 2. SQL Return Codes” on page 2-1, lists the SQL return codes. 


“Section 3. DB2 Messages” on page 3-1, lists, by type of message, the various DB2 
messages. 


“Section 4. DB2 Codes” on page 4-1, lists, by type of code, the various DB2 codes. 


1-2 DB2 Messages and Codes 


“Section 5. IRLM Messages and Codes” on page 5-1, lists, by type of message or 
code, the various IRLM messages and codes. 


Appendix A, “CICS Transaction Abend/Dump Code (DSNC)” on page X-3, explains 
the CICS transaction abend/dump code (DSNC). 


Appendix B, “Problem Determination” on page X-5, lists the diagnostic items and 
resource types you can use to resolve problems. 


How to Use This Book 


This introduction provides general information about DB2 messages. and codes. 
codes. You will be referred to it from appropriate places in the manual. However, 
it is recommended that you become familiar with this material ahead of time. 


The SQL return codes are listed by numeric sequence. The DB2 messages are 
listed in order of their subcomponent identifier and further by their numeric identi- 
fier. The codes are listed by their hexadecimal ID and further by their numeric 
identifier. The IRLM messages and codes are listed by numeric sequence. 


Message identifiers and subsystem identifiers are used to identify messages. 
Unless the message is issued by a subcomponent operating outside the DB2 envi- 
ronment (such as the precompiler or attachment facilities), messages are preceded 
by a subsystem recognition character that is defined during system installation. 
The subsystem recognition character is not shown in the message texts in this 
book. 


All DB2 message identifiers are eight characters long. The first three characters 
are always DSN: it is the DB2 subsystem prefix name. The fourth character is the 
subcomponent identifier: it identifies the subcomponent of DB2 that issued the 
message. Each subcomponent has an associated hexadecimal identifier (Hex ID): 
it is the hexadecimal representation of the subcomponent identifier. The fifth 
through seventh characters represent the numeric identifier: it is unique within the 
subcomponent. The last character of the message identifier is the message type 
code. It indicates the type of response that the message requires. A subsystem 
identifier is an optional field found after the message number: it is also known as 
the csect-name. Message identifiers and subsystem identifiers have the following 
format: 


DSNB209I DSNBICHK 


Where: 

DSN is the subsystem prefix name. 

B is the subcomponent identifier; in this example B identifies the DB2 
buffer manager and the HEX ID for this subcomponent is X'C2'. 

209 is the numeric identifier. 

I indicates that this message is for information only. 

DSNB1CHK is the subsystem identifier; it is an optional field. 
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The DB2 reason codes and subsystem termination reason codes are 4 bytes long. 
The first byte is always 00: it is the high-order byte. The second byte is the 
hexadecimal identifier (Hex ID): it identifies the DB2 subcomponent. The last 2 
bytes are the numeric identifier: it is unique within the subcomponent. The codes 
have the following format: 


00E50041 

Where: 

00 is the high-order byte. 

E5 is the hexadecimal identifier; it identifies the DB2 agent services 
manager. 

0041 is the numeric identifier. 


Figure 1. lists the DB2 subcomponents and shows the subcomponent identifiers for 
the messages and the hex ID for the reason codes. 


Figure 1. Subcomponent Identifiers Used in Messages and Reason Codes 


Subcomponent ID Hex ID 
Call attachment facility A X'C1' 
Buffer manager B X'C2' 
CICS attachment facility Cc X'C3' 
TSO attachment facility E X'C5' 
Message generator F X'C6' 
Precompiler, DSNH CLIST H X'C8' 
Data manager I xX'Cg' 
Recovery log manager J X'D1' 
Distributed data facility L X'D3' 
IMS/VS attachment facility M X'D4' 
Data space manager P X'D7' 
Recovery manager R X'D9' 
Storage manager Ss X'E2' 
Service controller, install T X'E3' 
Utilities U X'E4' 
Agent services manager V X'E5! 
Instrumentation facility W X'E6' 
Relational data system X X'E7' 
Initialization procedures Y X'E8' 
System parameter manager Z X'EQ' 
Service facilities 1 X'FI1' 
Subsystem support subcomponent 3 X'F3' 
Sample applications 8 X'F8' 
General command processor | 9 X'FQ' 
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Accompanying each message and code is the following information, when appli- 
cable: 


Explanation: This section tells what the message or code means, why it occurred, 
and what caused it. To assist in diagnosing problems, the CSECT(S) that issued the 
message are also included. 


System Action: This part tells what is happening as a result of the condition 
causing the message or code. If this information is not shown, no system action is 
taken. 


User Response: If a response by the user is necessary, this section tells what the 
pertinent responses are and their effect. If this information is not shown, no user 
response is required. 


Operator Response: If an operator response is necessary, this section tells what 
the pertinent responses are and their effect. If this information is not shown, no 
operator response is required. 


System Programmer Response: If a response by the system programmer is 
needed, this part tells what the pertinent responses are and their effect. If this 
information is not shown, no system programmer response is required. 


Programmer Response: lf a programmer response is necessary, this part tells 
what the pertinent responses are and their effect. If this information is not shown, 
no programmer response is required. 


Problem Determination: This section lists the actions that can be performed to 
obtain adequate data for support personnel to diagnose the problem. If this infor- 
mation is not shown, no problem determination is required. 


Message Type Codes | 
The last character of a message identifier is the type code. Four type codes are 
used, as shown in the following list: 


A Immediate action System operator action is required imme- 
diately. The associated task does not con- 
tinue until the requested action has been 
taken. 

D Immediate decision System operator decision or action is 
required immediately. The operator is 
requested to select from specific options, 
such as “retry” or “cancel”. The associated 
task does not continue until the requested 
decision has been made or action has been 
taken. 

E Eventual! action System operator action will be required; 
however, the associated task continues 
independently of system operator action. 

I Information only No operator action is required. 
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DB2 Message Severity Codes 
Messages issued by the precompiler subcomponent of DB2, as well as some mes- 
sages issued by the service controller and utility subcomponents of DB2, provide 
severity codes. The specific meanings of the severity codes differ slightly for each 
of the subcomponents. In general, the higher the severity level, the more signif- 
icant the situation. 


Severity codes for these subcomponents are described at the beginning of the indi- 
vidual subcomponent sections in “Section 3. DB2 Messages” on page 3-1. They 
are also included in the individual messages, where appropriate. 


DB2 Abend Completion Codes (X'04E' and X'04F) 
DB2 uses two system abend completion codes: X'04E' and X'04F'. 


X'04E' and X'04F' identify: 


¢ {Internal errors encountered during DB2 operation 
¢ Diagnostic information for problem determination 
e Subsystem actions initiated by the DB2 subcomponent involved in the error 


X'04E' 
An X'04E' abend completion code indicates that DB2 has detected an internal 
error and has abended a DB2 internal task (TCB) or a user-connected task. 
Errors associated with an X'04E' abend completion code may be preceded by 
an MVS system code or by internal errors. 


The diagnostic material generated by the X'04E' abend must be examined to 
determine the source of the error that actually resulted in a subsequent task or 
subsystem termination. 


X' 04F' 
An X'04F' abend completion code indicates that DB2 has detected a severe 
error and has abended the entire DB2 subsystem. When an X'04F' is issued, 
DB2 has determined that continued operation could result in the loss of data 
integrity. Errors associated with an X'04F' abend completion code may be 
preceded by an MVS system error or by one or more DB2 X'04E' abend com- 
pletion codes. 


Figure 2 on page 1-7 summarizes the diagnostic information and subsystem 
actions available to DB2 when these abend completion codes are issued. Some 
pieces of this information are not relevant to some error situations and will not 
help in problem diagnosis. In these cases, DB2 does not produce any diagnostic 
information that is unnecessary. The information that DB2 produces for a given 
error depends upon the specific problem. The MVS services that provide diag- 
nostic information are discussed in “DB2 Diagnostic Information” on page 1-7. 
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Figure 2. Abend Completion Codes 


Explanation 


System action 


| Diagnostic infor- 
| mation 


Associated 
reason codes 


| Location of 
| accompanying 
codes 


DB2 Diagnostic Information 


X'04E' 


Error during DB2 normal 
operation 


Internal DB2 task is 
abended 


Connected user task is 
abended 


SVC dump 
SYS1.LOGREC entry 
VRA data entries 


DB2 abend reason code 
Associated MVS system 
codes 


SVC dump title 
Message DSNWO050! 
Register 15 of SDWA 
section “General 
Purpose Registers at 
Time of Error” 
SYS1.LOGREC entries 
VRA data entries 


X'O4F 


Severe error; continued 
operation may jeopardize 
data integrity 


The entire DB2 subsystem 
is abended 

User task with an active 
DB2 connection may be 
abnormally terminated 
with an X'04F' 

Possible MEMTERM 
(memory termination) 

of connected allied 
address space 


SYS1.LOGREC 
VRADATA 


Subsystem termination 
reason code 

MVS system completion 
codes and X'04E' codes 
that precede the X'04F' 
abend 


SYS1.LOGREC 
VRADATA 

Message DSNVO86E, 
which is sent to MVS 
system operator 


DB2’s functional recovery routines use MVS services to provide diagnostic infor- 
mation for assistance in problem determination. 


The following MVS services provide diagnostic information: 


e SVC dumps 


The DB2 abend completion code X'04E' uses the MVS SDUMP service to 
create SVC dumps. The content and storage areas associated with these 
dumps vary depending on the specific error and the state of the DB2 subsystem 
at the time the error. 
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¢ SYS1.LOGREC 


Entries are requested in the SYS1.LOGREC data set at the time of the error 
using the MVS SETRP service. The foliowing are also recorded in 
SYS1.LOGREC: 


— Subsystem abnormal terminations 
— Secondary abends occurring in a recovery routine 
— Recording requests from recovery routines percolated to by RTM. 


e Variable recording area (VRA) data 


Data entries are added to the VRA of the SDWA by using an MVS VRA defined 
key. VRA data includes a series of diagnostic data entries common to all DB2 
abend completion codes. Additional information is provided by the invoking 
subcomponent recovery routine during initial error processing or RTM 
percolation. 


For detailed information on how to use these diagnostic aids, refer to Section 5 of 
Diagnosis Guide and Reference. 


MVS Abends Resulting from DB2 Operation 
During DB2 operation, an abend may occur with an MVS system completion code. 
If you receive an MVS abend during DB2 operation, refer to the appropriate MVS 
publication. 


How to Use the DB2 Library 


The most rewarding task associated with a database management system is 
asking questions of it and getting answers, the task we call end use. But other 
tasks are also necessary—defining the parameters of the system, putting the data 
in place, and so on. We group the tasks associated with DB2 into the following 
major categories: 


End use: End users want to issue SQL statements to retrieve data. Possibly they 
also insert, update, or delete data, still by means of SQL statements. They may 
need an elementary introduction to SQL, detailed instructions for using SPUFI, and 
an alphabetized reference to the types of SQL statements. Those are found in 
Application Programming and SQL Guide and SQL Reference. 


The same users may issue SQL statements through QMF or some other program, 
and the library for that program may provide all the instruction or reference mate- 
rial they need. For a list of titles in the QMF library, see the bibliography at the end 
of this book. 


Application Programming: Some users access DB2 without knowing it, using pro- 
grams that contain SQL statements. DB2 application programmers write those pro- 
grams. Since they write SQL statements, they need Application Programming and 
SQL Guide and SQL Reference, just as end users do. 


They also need instructions on many other topics; how to transfer data between 
DB2 and a host program—written in COBOL, C, or FORTRAN, for example; how to 
prepare to compile a program that embeds SQL statements; how to process data 
from two systems simultaneously, say DB2 and IMS or DB2 and CICS. The material 
you need for writing a host program containing SQL is in Application Programming 
and SQL Guide. And for those handling errors, we also recommend this book. 
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System and Database Administration: Administration covers almost everything 
else. Administration Guide (Volumes 1, 2 and 3) divides those tasks among the fol- 
lowing sections: 


e Section 2 (Volume 1) of Administration Guide deals with defining the DB2 
system, estimating storage needs, and running the jobs that install the DB2 
program. 


e Section 3 (Volume 1) of Administration Guide explains how to connect several 
DB2 subsystems for communication using distributed data. 


¢ Section 4 (Volume 2) of Administration Guide discusses the decisions that must 
be made when designing a database and tells how to bring the design into 
being by creating DB2 objects, loading data, and adjusting to changes. 


¢ Section 5 (Volume 2) of Administration Guide describes ways of controlling 
access to the DB2 system and to data within DB2, to audit aspects of DB2 usage, 
and to answer other security and auditing concerns. 


e Section 6 (Volume 2) of Administration Guide describes the steps in normal 
day-to-day operation and discusses the steps one should take to prepare for 
recovery in the event of some failure. 


* Section 7 (Volume 3) of Administration Guide explains how to monitor the per- 
formance of the DB2 system and its parts. It also lists things that can be done 
to make some parts run faster. 


In addition, the appendixes in Administration Guide contain valuable information 
on DB2 sample tables, National Language Support (NLS), writing exit routines, and 
interpreting DB2 trace output. The information previously in the separate book /BM 
DATABASE 2 Version 2 Instrumentation Facility Interface is now an appendix. 


If you are involved with DB2 only to install the system, design the database, or plan 
operational procedures, Administration Guide may be ail you need. If you also 
intend to carry out your own plans by creating DB2 objects, granting privileges, 
running utility jobs, and so on, then you also need: 


¢ SQL Reference, which describes the SQL statements you use to create, alter, 
and drop objects and grant and revoke privileges 

¢ Command and Utility Reference, which explains how to run commands and 
utilities 

¢ This book. 


Diagnosis: A diagnostician detects and describes errors in the DB2 program. He 
or she may also recommend or apply a remedy. The documentation needed for 
the task is in Diagnosis Guide and Reference and this book. 


Titles of books in the DB2 library begin with IBM DATABASE 2 Version 2. However, 
references from one DB2 book to another are shortened and do not include the 
product title. Instead, they point directly to the section that holds the information. 
For a complete list of books in the DB2 library, and the sections in each book, see 
the back cover of this book. 
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Summary of Changes to DB2 


Release 2 


Version 2 Release 2 offers distributed database support. A DB2 user or application 
program connected to one DB2 subsystem can access data stored at another DB2 
subsystem. 


DB2 distributed database supports all of the function available in Version 2 Release 
1, plus the following new features: 


¢ Authorization is done at the system where the tables reside. For example, a 


user at Branch 1 wanting to access data at Branch 2 must be authorized at 
Branch 2 to do this. The DB2 system at Branch 2 identifies the Branch 1 user 
by an authorization identifier. If the Branch 1 user wants to select data from a 
Branch 2 table, authority to do so must be granted at Branch 2. 
Auditing of data is done at the site where the tables reside. So, if a user at 
Branch 1 is authorized to perform queries on Branch 2 tables, the work done 
on those tables is audited at Branch 2. 
DB2 Governor is extended to provide a system to control the amount of 
resources used by remote users. When a user from Branch 1 attempts to run 
queries on Branch 2 tables, the queries can be terminated by Branch 2 if the 
time limit is exceeded. 
Data Manipulation SQL statements are supported among DB2 systems. You 
can update, insert and delete data at different sites if your connection is 
through TSO or the call attachment facility (CAF). You can select data at dif- 
ferent sites if your connection is through TSO, CAF, IMS, or CICS. Data defi- 
nition SQL statements — GRANT, REVOKE, CREATE, DROP, and ALTER — are 
supported at the system where the tables reside. 

— Remote Update Capabilities are provided for a single site per commit 
scope with TSO and CAF. An authorized user at Branch 1 can update, 
insert, or delete data at Branch 2 if TSO or CAF is used. However, an 
update at any site, remote or local, must be committed before additional 
updates at a different site may be performed. 


This remote update capability is provided for DB2 users connected through 
TSO or CAF only. Users connected through IMS or CICS may not perform 
remote updates; however, they may update local data and they may select 
data from any site. 
~ Remote Query Capabilities are provided for multiple sites per commit 
scope. SELECT statements may be made to the local and to multiple 
remote sites without committing data after each one. However, each 
SELECT statement must reference only one DB2 system. All DB2 users, 
connected through TSO, CAF, IMS or CICS, have this remote query capa- 
bility. 
Portability of applications and data is easy between DB2 systems. Because of 
the three-part naming convention available with DB2 Version 2 Release 2, the 
end user or application program can point directly to data at a specific 
location. In addition, by defining alias table names, you can access data that 
frequently moves from one site to another. 
Install, Migration, and Fall Back are similar to past releases of DB2. However, 
a new option, the distributed data facility, must be selected at install or 
migration in order to use DB2 data in a distributed environment. In addition, a 
communications database must be created at install or migration so that DB2 
systems can communicate with each other through VTAM. If the communi- 
cations database is not created at install or migration, it can be created by an 
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Release 1 


authorized user after DB2 is operational. The distributed data facility cannot be 
started until the communications database has been created. Migration to DB2 
Version 2 Release 2 is supported only from DB2 Version 2 Release 1 and from 
DB2 Version 1 Release 3. Fail back is supported from DB2 Version 2 Release 2 
to DB2 Version 2 Release 1 and to DB2 Version 1 Release 3. You ey only fall 
back to the release from which you migrated. 


Version 2 Release 1 offers all of the functions available with Version 1, plus: 


Referential integrity, which provides the ability to have DB2 ensure that refer- 
ences from one table to another are valid. You can define referential con- 
straints which are automatically enforced on the tables to which they apply. 
Performance enhancements that significantly improve transaction, query, data 
definition, and utility response time. Not only is response time improved, but 
the amount of machine resource used by DB2 is reduced, freeing it for other 
purposes. 

MVS/ESA support enhancements which allow MVS/ESA customers to take 
advantage of improvements in performance and recovery for multiple address 
space operations. These improvements provide greater efficiency in hardware 
resource use from which DB2 directly benefits. 

Application development and tuning flexibility enhancements. Before loading 
data, you do not need to create indexes as often as you did in past releases of 
DB2. If and when additional indexes are needed, they can be created more 
quickly and they are well-organized. 

Authorization control that is more flexible. A user can be represented not only 
by a single (primary) authorization identifier, but also by one or more sec- 
ondary identifiers, which can serve as group identifiers. This is helpful when 
using a security system like RACF. Users can also create objects to be owned 
by their secondary identifiers. 

Audit trace that allows you to determine who has accessed data stored in DB2 
tables. The trace can record events of several types, such as unauthorized 
access attempts, write accesses, and read accesses. 

Resource limit facility, or governor, to control the amount of resources used 
when certain SQL queries are run. The governor terminates dynamic queries 
that exceed a predetermined time limit. 

Recovery of data enhancements. The RECOVER utility allows multiple table 
spaces and partitions to be recovered at the same time. 

Recovery point in time, with the addition of the QUIESCE utility. This allows you 
to establish a point at which a list of table spaces is consistent. 

LOAD utility enhancements in detecting and processing unique index vio- 
lations. When the LOAD utility detects duplicate values for unique indexes, 
duplicate data is not loaded. 

Segmented table spaces, which provide performance advantages for storing 
more than one table in a single table space. 

Alter storage attributes ability. You can reassign table spaces, index spaces, 
and partitions to different storage groups or to user-managed data sets. 
DFHSM (Data Facility Hierarchical Storage Manager) support enhancements. 
You can perform synchronous automatic recail controlled by a time value you 
set. 

DL/I batch support. This programming enhancement allows you to access IMS 
data and DB2 data in the IMS batch environment. 

National Language Support to display DB2! help and task panels in Kanji. 
Serviceability improvements to decrease service costs and problem resolution 
time. 

A subset of American National Standards Institute (ANSI) SQL support. 
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Throughout this book, the term MVS is used to represent both MVS/Enterprise 
Systems Architecture (MVS/ESA) and MVS/Extended Architecture (MVS/XA). When it 
is necessary to make a technical distinction between the two environments, the 
specific term is used. C/CS is used to represent both CICS/OS/VS and CICS/MVS; 
IMS is used to represent both IMS/VS and IMS/ESA; C and C language are used to 
represent the C/370 programming language. 


Summary of Changes to This Book 


Many new messages and codes have been added. New messages and codes, and 
changes to existing messages and codes, are marked with revision bars. 


An explanation of resource types and codes has been added to Appendix B, 
“Problem Determination” on page X-5. 
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Section 2. SQL Return Codes 


This section is intended to help you to use the SQL that specialized purpose. Because of its depend- 
return codes. That interface is product-sensitive, ency on detailed design and implementation, it is 
as defined in “Statement of Purpose” on page 1-1. to be expected that programs written to use the 
That product-sensitive interface is provided to SQL return codes may need to be changed in 
allow you to diagnose the activity of the product. It order to run with new product releases or ver- 

is dependent on the detailed design or implemen- sions, or as a result of service. 


tation of the product. It should be used only for 
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Introduction 


Structured Query Language (SQL) return codes, 
and the tokens referred to in the explanations, are 
returned in the SQL communication area (SQLCA). 


The SQLCA is an area in the application program 
(defined by the application program) for the use of 
DB2. It is described in Appendixes of SQL Refer- 
ence. Additional information about the SQLCA can 
be found in Section 5 of Diagnosis Guide and Ref- 
erence. 


The SQL return code is returned in the SQLCODE 
field of the SQLCA. The tokens are returned in the 
SQLERRM field. If there are several tokens, they 
appear sequentially in SQLERRM in the order in 
which they appear in the message text. The 
tokens are separated by the character X'FF'. 


A token appears in the message text in lowercase 
letters. When an SQL return code is returned 
through SPUFI, the tokens have been substituted 
into the message text and the text is displayed. 
The substitution of tokens into message text is per- 
formed by a DB2 module named DSNTIAR. This 
module can also be used by application programs. 
Refer to Section 3 of Application Programming and 
SQL Guide for more information about DSNTIAR. 


SQLCA Message Formatter 


Message Severity Codes 


Some service controller messages show a severity 
code. These severity codes are derived from the 
results of processing SQL statements and have the 
following meanings: 


0 Successful Corresponds to 
execution SQLCODE 000 

4 Warning Corresponds to a posi- 
tive SQLCODE or to 
SQLWARN from the 
SQLCA 

8 Error Corresponds to a nega- 
tive SQLCODE 

12 Severe error Indicates incorrect 
SQLCA format 


000 — +218 


Successful Execution SQLCODE 


000 SUCCESSFUL EXECUTION 


Explanation: The SQL statement has probably executed suc- 
cessfully. Check SQLWARNGO to ensure that it is blank. If it is 
biank, the statement executed successfully. If it is not blank, a 
warning condition exists. Check the other warning indicators to 
determine the particular warning condition. For example, if 
SQLWARN‘1 is not blank, a string has been truncated. 


Warning SQLCODES 


+100 ROW NOT FOUND FOR FETCH, UPDATE OR 
DELETE, OR THE RESULT OF A QUERY IS AN 


EMPTY TABLE 
Explanation: One of the following conditions occurred: 


¢ No row met the search conditions specified in an UPDATE 
or DELETE statement. 


¢ The result of a SELECT INTO statement was an empty table. 


e A FETCH statement was executed when the cursor was 
positioned after the last row of the result table. 


© The result of the subselect of an INSERT statement is 
empty. 


When a SELECT statement is executed using SPUFI, this SQL 
code indicates normal completion. 


System Action: No data was retrieved, updated, or deleted. 


+162 TABLESPACE database-name.tablespace-name 


HAS BEEN PLACED IN CHECK PENDING 


Explanation: The indicated table space is in the CHECK 
PENDING state because ALTER TABLE was used to specify a 
referential constraint on a populated table. The table space is 
not generally available until the CHECK PENDING state is 
removed from the table space. 


System Action: The table space has been placed in CHECK 
PENDING state. 


Programmer Response: The use of CHECK DATA is advised. 


+218 THE SQL STATEMENT REFERENCING A REMOTE 


OBJECT CANNOT BE EXPLAINED. 


Explanation: The user has used EXPLAIN(YES) on the bind 
command to bind an application which has SQL statement ref- 
erencing a remote object or the user has a static EXPLAIN SQL 
statement which references a remote object in the application 
program. EXPLAIN a remote object is not supported by DB2. 


This warning message is issued by the following CSECT(s): 
DSNXOFCR at BIND time, and it is issued only with 
VALIDATE(RUN). 


System Action: The application pian will be bound success- 
fully, but no information wil! be filled in the user’s PLAN-TABLE 
for the SQL statement referencing a remote object. A -512 
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+304 — +802 


SQLCODE will be issued at RUNTIME if the EXPLAIN statement 
is found to explain a remote object. 


+304 A VALUE WITH DATA TYPE data-type1 CANNOT 
BE ASSIGNED TO A HOST VARIABLE BECAUSE 
THE VALUE IS NOT WITHIN THE RANGE OF THE 
HOST VARIABLE IN POSITION position-number 


WITH DATA TYPE data-type2 


Explanation: A FETCH or SELECT into a host variable list or 
structure, position number 'position-number' failed because 
the host variable having data type 'data-type2' was not large 
enough to hold the retrieved value having data type 
‘data-type1'. 


System Action: The FETCH or SELECT could not return the 
data for the indicated SELECT item, the indicator variable is set 
to negative two (-2) to indicate a null value returned. Proc- 
essing continues. 


Programmer Response: Verify that table definitions are 

current, and that the host variable has the proper data type. 

See the explanation for SQL return code -405 for ranges of SQL 
data types. | 


+402 LOCATION location IS UNKNOWN 


Explanation: A remote object is referenced and either the 
table SYSIBM.SYSLOCATIONS is not defined or the referenced 
‘location' matches no entry in the 
SYSIBM.SYSLOCATIONS.LOCATION column. 


System Action: For the CREATE ALIAS statement, the alias is 
created. For binding a plan with the VALIDATE(RUN) option, 
the plan is created. 


+403 THE LOCAL OBJECT REFERENCED BY THE 


CREATE ALIAS STATEMENT DOES NOT EXIST 


Explanation: The local object referenced by the CREATE ALIAS 
statement does not exist when creating the alias. 


System Action: The alias is created. 


+558 THE WITH GRANT OPTION IS IGNORED BECAUSE 


GRANT IS TO PUBLIC 


Explanation: The GRANT statement specified both WITH 
GRANT OPTION, and PUBLIC within its list of 'grantee' authori- 
zation IDs. A privilege cannot be granted to PUBLIC with the 
GRANT option. 


System Action: The specified privileges were granted to 
PUBLIC, but without the GRANT option. If other authorization 
IDs were also specified in the list of grantees, those IDs were 
granted the specified privilege(s) with the GRANT option. 


+560 THE WITH GRANT OPTION IS IGNORED FOR 


UPDATE (COLUMN-LIST) 


Explanation: The GRANT statement specified UPDATE 
(COLUMN-LIST) WITH GRANT OPTION within its list of privi- 
leges to be granted. The UPDATE (COLUMN-LIST) privilege 
cannot be granted to an authorization ID with the GRANT 
option. 


System Action: The specified UPDATE (COLUMN-LIST) privi- 
lege was granted to the authorization ID(s), but without the 
GRANT option. if other privileges were also specified in the list 
of privileges to be granted, those privileges were granted to the 
specified authorization ID(s) with the GRANT option. 


2-4 DB2 Messages and Codes 


+561 THE ALTER AND INDEX PRIVILEGES CANNOT BE 


GRANTED TO "PUBLIC AT ALL LOCATIONS" 


Explanation: You entered a GRANT statement with either an 
ALL or ALL PRIVILEGES keyword. ALL and ALL PRIVILEGES 
imply the granting of ALTER and INDEX privileges that cannot 
be granted to a remote user. 


System Action: DB2 executes the GRANT statement; however, 
it does not grant the ALTER and INDEX privileges to “PUBLIC*”. 


+625 THE DEFINITION OF TABLE table-name HAS BEEN 


CHANGED TO INCOMPLETE 


Explanation: This warning code is used to report that the defi- 
nition of the indicated table is incomplete because DROP INDEX 
was used to drop its primary index. The table is not generally 
available until a new primary index is created. 


System Action: The definition of the table is marked as incom- 
plete. Subsequent references to the table in DDL or DML state- 
ments will cause SQL code -540 to be returned. Attempts to run 
already bound plans referencing the table will result in SQL 
-904 or -923 with resource unavailable reason code 00C9009F. 
CHECK and LOAD utilities involving the tabie are not allowed. 
if they are used, you will receive message DSNU305I or 
DSNT500! with reason code O0C9009F. Utilities other than 
CHECK and LOAD are allowed. 


Programmer Response: Recreate the primary index using 
CREATE INDEX. This will remove the table from INCOMPLETE 
DEFINITION status. 


Note: The reason that a primary index may need to be dropped 
and recreated is to change the STOGROUP or SUBPAGES 
parameters of the index. 


+802 EXCEPTION ERROR exception-type HAS 
OCCURRED DURING operation-type OPERATION 


ON data-type DATA, POSITION position-number 


Explanation: The exception error 'exception-type' occurred 
while doing an ADDITION, SUBTRACTION, MULTIPLICATION, 
DIVISION, or NEGATION operation on a field whose 'data-type' 
is DECIMAL, FLOAT, SMALLINT, or INTEGER. The error 
occurred while processing an arithmetic expression in the 
SELECT list of an outer SELECT statement, and the position in 
the select list is denoted by 'position-number'. The possible 
exception types are FIXED POINT OVERFLOW, DECIMAL OVER- 
FLOW, DIVIDE EXCEPTION, and EXPONENT OVERFLOW. The 
data type displayed in the message may indicate the data type 
of the temporary internal copy of the data, which may differ 
from the actual column or literal data type due to conversions 
by DB2. 


A fixed point overflow can occur during any arithmetic opera- 
tion on either INTEGER or SMALLINT fields. 


A decimal overflow exception can occur when one or more non- 
zero digits are lost because the destination field in any decimal 
operation is too short to contain the result. 


A divide exception can occur on a division operation on any 
numeric field type (DECIMAL, FLOAT, SMALLINT, or INTEGER) 
by zero, or on a decimal division operation when the quotient 
exceeds the specified data-field size. 


An exponent overflow can occur when the result characteristic 
of any floating point operation exceeds 127 and the result frac- 
tion is not zero, i.e. the magnitude of the result exceeds approx- 
imately 7.2E+75. 


Note: Parts of 'exception-type', 'data-type', 'operation-type' 
‘position-number' may or may not be returned in SQLCA, 
depending upon when the error was detected. 


System Action: For each expression in error the indicator vari-_ 


able is set to negative two (-2) to indicate a nul! value returned. 
The data variable is unchanged. Execution of the statement 
continues with all non-error columns and expressions of the 
outer SELECT list being returned. If the statement is cursor 
controlled then the CURSOR will remain open. 


Programmer Response: Examine the expression for which the 
warning occurred to see if the cause (or the likely cause) of the 
problem can be determined. The problem may be data- 
dependent, in which case it will be necessary to examine the 
data that was being processed at the time the error occurred. 


See the explanation of SQLCODE -405 for allowed ranges of 
numeric datatypes. 


Error SQLCODES 


-007 STATEMENT CONTAINS THE ILLEGAL CHAR- 


ACTER character 


Explanation: The specified 'character' is not a valid character 
in SQL statements. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the syntax and resubmit the 
statement. Refer to Chapter 3 of SQL Reference for information 
about the valid SQL character set. 


-010 THE STRING CONSTANT BEGINNING string IS 


NOT TERMINATED 


Explanation: The statement contains a string constant, begin- 
ning with 'string', that is not terminated properly. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the statement for missing 


quotation marks or apostrophes in the indicated string constant. 


-060 INVALID type SPECIFICATION : spec 


Explanation: ‘type' is either LENGTH or SCALE. 'spec' is the 
specified length or scale. Length or scale must be specified by 
an unsigned integer constant and the value must be in the 
range allowed by the data type. This error pertains to the 
DECIMAL function. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement. Refer to 
Chapter 3 of SQL Reference for rules for length and scale. 


-084 UNACCEPTABLE SQL STATEMENT 


Explanation: This SQL statement is unacceptable to DB2. One 
of the following has occurred: 


¢ An attempt has been made to PREPARE or EXECUTE IMME- 
DIATE a SQL statement that cannot be prepared; for 
example, FETCH or INCLUDE. 


¢ The embedded SQL statement is not an SQL statement sup- 
ported by DB2. 


System Action: The statement cannot be executed. 


Programmer Response: If the situation involves an SQL state- 
ment that cannot be prepared, the problem is in the source of 
the SQL statement, not the application program. Thus, no 
action is necessary unless the source of the SQL statement is 
the application program itself. 


-007 — -107 


If the situation involves a SQL statement that is not supported 
by DB2, remove it from the application program and precompile 
again. 


-101 THE STATEMENT IS TOO LONG OR TOO 


COMPLEX 


Explanation: The statement cannot be executed because it 
exceeds the system limits for either length or complexity. 


System Action: The statement cannot be executed. 


Programmer Response: Break the statement up into shorter or 
less complex SQL statements. 


-102 THE LENGTH OF THE STRING CONSTANT BEGIN- 
NING string IS GREATER THAN 254 CHARACTERS 


OR 124 GRAPHIC CHARACTERS 


Explanation: The string constant beginning with 'string' has a 
length greater than 254 characters or 124 graphic characters. 
Character strings with lengths greater than 254 and graphic 
strings with lengths greater than 124 can be specified only 
through assignment from host variables. 


System Action: The statement cannot be executed. 


Programmer Response: The requested function is not avail- 
able interactively. If the error occurred in the context of an SQL 
statement embedded in an application program, the desired 
result can be achieved by assigning the long string to a host 
variable, and substituting that variable for the string literal in 
the SQL statement. 


-103 literal IS AN INVALID NUMERIC LITERAL 


Explanation: The indicated ‘literal’ begins with a digit, but is 
not a valid integer, decimal, or float literal. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the invalid literal. 


-104 ILLEGAL SYMBOL token VALID SYMBOLS ARE 


token-list 


Explanation: A syntax error in the SQL statement was detected 
at 'token'. 


A partial list of valid tokens, 'token-list', is provided. This list 
assumes that the statement is correct up to that point, and only 
as many tokens are listed as will fit. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the statement in the area of 
the specified token. 


-105 INVALID STRING 


Explanation: The statement contains an invalid string. It is 
neither a character string, nor a graphic string. 


System Action: The statement cannot be executed. 


Programmer Response: Specify the correct format of the 
string. Check for a graphic string, paired delimiters, the char- 
acter G, and an even number of bytes within the string. 


THE NAME name IS TOO LONG. MAXIMUM 
ALLOWABLE SIZE IS size 


-107 


Explanation: The name returned as 'name' is too long. The 
maximum permissible tength for names of that type is indicated 
by ‘size’. 
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-109 — -118 


Names for the following cannot contain more than 18 characters 
(20: including SQL escape characters, if present): 


¢ SQL columns 
° SQL tables 

e SQL views 

e SQL indexes 

¢ SQL aliases 

¢ SQL synonyms. 


The following cannot contain more than 8 characters: 


° Table qualifiers 

© View qualifiers 

e Library member names specified in an INCLUDE statement 

¢ Storage group names 

¢ Database names 

¢ Table space names 

¢ Application plans 

¢ Database request modules (DBRMs) 

¢ Constraint names specified in CREATE or ALTER TABLE 
statements. 


Host variable names cannot contain more than 64 characters. 
Volume serial numbers cannot contain more than 6 characters. 
Labels cannot contain more than 30 characters. 


System Action: The statement cannot be executed. 


Programmer Response: Choose a shorter name for the object. 


-109 clause CLAUSE IS NOT PERMITTED 


Explanation: The indicated clause is not permitted in the 
context in which it appears in this SQL statement. A subselect 
cannot have an INTO clause. A CREATE VIEW statement cannot 
have INTO, ORDER BY, or FOR UPDATE clauses. An embedded 
SELECT statement cannot have ORDER BY or FOR UPDATE 
clauses. SELECT statements used in cursor declarations 
cannot have an INTO clause. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the SQL statement. 


-110 INVALID HEXADECIMAL LITERAL BEGINNING 
string 


Explanation: The literal beginning with the specified 'string' 
contains one or more characters that are not valid hexadecimal 
digits. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the invalid literal. 


“111 A COLUMN FUNCTION DOES NOT INCLUDE A 


COLUMN NAME 


Explanation: The specification of a column function (AVG, 
MAX, MIN, or SUM) was invalid because such functions must 
include a column name in the operand. If the column name is 
that of a view, it must not be a derived column, that is, derived 
from a constant, expression, or function. 


System Action: The statement cannot be executed. 


Programmer Response: A column name must be specified as 
an operand to the function. Refer to Chapter 4 of SQL Refer- 
ence for information about the proper usage of column func- 
tions. 
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“112 THE OPERAND OF A COLUMN FUNCTION IS 
ANOTHER COLUMN FUNCTION OR DISTINCT FOL- 
LOWED BY AN EXPRESSION 


Explanation: The operand of a column function is another 
column function, or DISTINCT followed by an expression. Only 
expressions without functions or DISTINCT followed by a 
column reference (not an expression) are permitted as oper- 
ands of a column function. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the function specification. 
Refer to Chapter 4 of SQL Reference for information about the 
proper usage of column functions. 


-113 INVALID CHARACTER FOUND IN NAME: name 


Explanation: The specified 'name' contains a character that is 
not permitted in DB2 names. Short delimited identifiers cannot 
contain special characters. 


Unless the KATAKANA option or escape characters are used, 
names can contain only alphabetic, national (#, $, @), or 
numeric characters. The first character must be an alphabetic 
or national character. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the name. Refer to Chapter 3 
of SQL Reference for information about SQL naming con- 
ventions. 


“115 A PREDICATE IS INVALID BECAUSE THE COM- 
PARISON OPERATOR operator IS FOLLOWED BY 
A PARENTHESIZED LIST OR BY ANY OR ALL 
WITHOUT A SUBQUERY 


Explanation: A simple comparison like '>' must not be fol- 
lowed by a list of items. ANY and ALL comparisons must be fol- 
lowed by a subselect, rather than an expression or a list of 
items. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the SQL statement. Refer to 
Chapter 5 of SQL Reference for information about the syntax of 
SQL statements. 


-117 THE NUMBER OF INSERT VALUES IS NOT THE 
SAME AS THE NUMBER OF OBJECT COLUMNS 


Explanation: The number of insert values in the value list of 
the INSERT statement is not the same as the number of object 
columns specified. 


System Action: The statement cannot be executed. No data 
was inserted into the object table. 


Programmer Response: Correct the statement to specify one 
and only one value for each of the specified object columns. 


-118 THE OBJECT TABLE OR VIEW OF THE INSERT, 
DELETE, OR UPDATE STATEMENT IS ALSO IDEN- 
TIFIED IN A FROM CLAUSE 


Explanation: The table or view specified as the object of an 
INSERT, DELETE, or UPDATE statement also appears in the 
FROM clause of a subselect within the statement. 


The tabie or view that is the object of an INSERT, UPDATE, or 
DELETE cannot also be used to supply the values to be inserted 
or to qualify the rows to be inserted, updated, or deleted. 


System Action: The statement cannot be executed. No data 
was inserted, updated, or deleted. 


Programmer Response: The implied function is not supported 
by DB2. It may be possible to obtain the desired result by cre- 
ating a temporary copy of the object table or view and 
addressing the subselect to that copy. Refer to Chapter 5 of 
SQL Reference for information about the syntax of SQL state- 
ments. 


-119 A COLUMN IDENTIFIED IN A HAVING CLAUSE IS 


NOT INCLUDED IN THE GROUP BY CLAUSE 


Explanation: A column identified in a HAVING clause (possibly 
within a scalar function) does not appear in the GROUP BY 
clause. Columns specified in a HAVING clause must appear 
within column functions or also be specified in the GROUP BY 
clause. 


System Action: The statement cannot be executed. 


Programmer Response: The implied function is not supported 
by DB2. Refer to Chapter 5 of SQL Reference for information 
about the proper usage of HAVING and GROUP BY clauses. 


-120 A WHERE CLAUSE OR SET CLAUSE INCLUDES A 


COLUMN FUNCTION OR A WHERE CLAUSE REF- 
ERENCES A COLUMN [column-name] WHICH IS 
DERIVED FROM A COLUMN FUNCTION OR 
EXPRESSION IN A VIEW DEFINITION 


Explanation: One of the following conditions exists: 
e A WHERE clause or SET clause contains a column function. 


e A WHERE clause references a column that is derived from 
a column function or expression in a view definition. 


A column function is allowed in a WHERE clause only if the 
’ WHERE clause appears within a subquery of a HAVING clause. 


System Action: The statement cannot be executed. 


Note: The 'column-name' may or may not be returned in 
SQLCA, depending on the nature of the error occurring in the 
SQL statement. 


Programmer Response: The implied function is not supported 
by DB2. Refer to Chapter 5 of SQL Reference for information 
about restrictions on operands that can be specified within 
WHERE and SET clauses. 


“121 THE COLUMN name IS IDENTIFIED MORE THAN 


ONCE IN THE INSERT OR UPDATE STATEMENT 


Explanation: The same column 'name' is specified more than 
once, either in the list of object columns of an INSERT state- 
ment, or the SET ciause of an UPDATE statement. 


System Action: The statement cannot be executed. No data 
was inserted or updated in the object table. 


Programmer Response: Correct the syntax of the statement so 
that each column name is specified only once. 


-122 A SELECT STATEMENT WITH NO GROUP BY 
CLAUSE CONTAINS A COLUMN NAME AND A 
COLUMN FUNCTION IN THE SELECT CLAUSE OR 
A COLUMN NAME IS CONTAINED IN THE SELECT 
CLAUSE BUT NOT IN THE GROUP BY CLAUSE 


Explanation: The SELECT statement contains one of three 
types of errors: 


¢ The statement contains a column name and a column func- 
tion in the SELECT clause, but no GROUP BY clause. 


-119 — -128 


¢ Acolumn name is contained in the SELECT clause (possibly 
within a scalar function) but not in the GROUP BY ciause. 


¢ Acolumn referenced in a GROUP BY clause is a view 
column derived from a constant, an expression, or a func- 
tion. 


System Action: The statement cannot be executed. 


Programmer Response: Refer to Chapter 5 of SQL Reference 
for information about the use of GROUP BY clauses in SQL 
statements. 


-125 AN INTEGER IN THE ORDER BY CLAUSE DOES 
NOT IDENTIFY A COLUMN OF THE RESULT 


Explanation: The ORDER BY clause in the statement contains 
a column number that is either less than one, or greater than 
the number of columns of the result table (the number of items 
in the SELECT clause). 


System Action: The statement cannot be executed. 


Programmer Response: Correct the syntax of the ORDER BY 
clause such that each column identifier properly denotes a 
column of the result table. 


-126 THE SELECT STATEMENT CONTAINS BOTH AN 
UPDATE CLAUSE AND AN ORDER BY CLAUSE 


Explanation: The SELECT statement in the declaration for a 
cursor contains both an UPDATE clause and an ORDER BY 
clause. An ORDER BY clause cannot be specified in the decla- 
ration for a cursor that is to be used for update. 


System Action: The statement cannot be executed. The cursor 
remains undefined in the application program. 


Programmer Response: The implied function is not supported 
by DB2. A cursor that is to be used for update cannot be 
defined to fetch the rows of the object table in a specific order. 


Refer to Chapter 5 of SQL Reference for information about 
restrictions on the declarations for cursors to be used for 
update. 


-127 DISTINCT IS SPECIFIED MORE THAN ONCE INA 
SUBSELECT 


Explanation: The DISTINCT qualifier can be used only once in 
a SELECT statement or a subselect. 


System Action: The statement cannot be executed. 


Programmer Response: The implied function is not supported 
by DB2. Refer to Chapter 5 of SQL Reference for information 
about restrictions on the use of the DISTINCT qualifier. 


-128 INVALID USE OF NULL IN A PREDICATE 


Explanation: The use of NULL in the search condition does not 
conform to the rules of SQL syntax. 


System Action: The statement cannot be executed. 


Programmer Response: The implied function is not supported 
by DB2. Refer to Chapter 3 of SQL Reference for information 
about the proper use of the NULL operand. 


SQL Return Codes 2-7 


-129 — -150 


-129 THE STATEMENT CONTAINS TOO MANY TABLE 


NAMES 


Explanation: A subselect can have a maximum of 15 refer- 
ences to table names. 


System Action: The statement cannot be executed. 


Programmer Response: Break the SQL statement into two or 
more simpler statements with 15 or fewer table references in 
each. The count will include the number of base tables of each 
view on the FROM list. 


-131 STATEMENT WITH LIKE PREDICATE HAS INCOM- 


PATIBLE DATA TYPES 


Explanation: If the column name at the left of LIKE or NOT LIKE 
is of type character, the expression at the right must be of type 
character. !f the column name is of type graphic, the 
expression at the right must be of type graphic. 


System Action: The statement cannot be executed. 


Programmer Response: Check the data type of every operand. 


-132 A LIKE PREDICATE IS INVALID BECAUSE THE 


FIRST OPERAND IS NOT A COLUMN OR THE 
SECOND OPERAND IS NOT A STRING 


Explanation: A LIKE predicate appearing in the statement is 
invalid, either because the first operand is not.a column name, 
or the second operand is not a string. 


The token appearing on the left of a LIKE or NOT LIKE predicate 
must be a column name. The value appearing on the right of 
the predicate must be a string constant or variable. 


System Action: The statement cannot be executed. 


Programmer Response: The implied function is not supported 
by DB2. Refer to Chapter 3 of SQL Reference for information 
about the proper syntax for LIKE and NOT LIKE predicates. 


-133 A COLUMN FUNCTION IN A SUBQUERY OF A 


HAVING CLAUSE IS INVALID BECAUSE IT 
INCLUDES AN EXPRESSION THAT APPLIES AN 
OPERATOR TO A CORRELATED REFERENCE 


Explanation: A column function appearing in a subquery of a 
HAVING clause is invalid because it applies an operator toa 
correlated reference. An arithmetic operation cannot be per- 
formed on a correlated reference in a subquery of a HAVING 
clause. 


System Action: The statement cannot be executed. 


Programmer Response: Refer to Chapter 5 of SQL Reference 
for information about restrictions on the syntax of the HAVING 
clause. 


“134 IMPROPER USE OF LONG STRING COLUMN 
column-name OR A HOST VARIABLE OF 
MAXIMUM LENGTH GREATER THAN 254 


Explanation: Such a column or host variable cannot appear in 
ORDER BY or GROUP BY clauses, UNION subqueries, subse- 
lects, or functions. SUBSTR is the only scalar function that can 
have use long string values. LIKE and NOT LIKE are the only 
predicates that can use long string values. 


System Action: The statement cannot be executed. 


Note: The 'column-name' might not be returned in SQLCA, 
depending on the nature of the error and the syntax in which it 
occurred. 
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Programmer Response: The requested operation on a long 
string value is not supported by DB2. Refer to Chapter 3 of SQL 
Reference for information about restrictions on the specification 
and manipulation of long string values. 


-136 SORT CANNOT BE EXECUTED BECAUSE THE 
SORT KEY LENGTH IS GREATER THAN 4000 
BYTES 


Explanation: A sort key is derived from the list of columns 
specified following a DISTINCT qualifier, or in an ORDER BY or 
GROUP BY clause. If both a DISTINCT qualifier and an ORDER 
BY or GROUP BY clause are present, the sort key is derived 
from the combination of both lists of columns. 


The internal \ength of the sort key cannot exceed 4000 bytes. In 
attempting to process the SQL statement, the internal length of 
the sort key derived from the DISTINCT and/or ORDER BY or 
GROUP BY specifications was found to exceed that 4000-byte 
maximum. 


System Action: The statement cannot be executed. 


Programmer Response: The statement must be modified such 
that the internal length of the sort key will not exceed 4000 
bytes. In general, this means that one or more column names 
must be deleted from the ORDER BY or GROUP BY clause, or 
the list following the DISTINCT qualifier. 


-137 RESULT OF CONCATENATION TOO LONG 


Explanation: The iength of the result of a concatenation 
exceeds 32,764 (if character operands) or 16,382 (if graphic 
operands). 


System Action: The statement cannot be executed. 


Programmer Response: Ensure that the total of the lengths of 
the concatenated operands is Jess than or equal to 32,764 (for 
character operands) or 16,382 (for graphic operands). 


-138 THE SECOND OR THIRD ARGUMENT OF THE 
SUBSTR FUNCTION IS OUT OF RANGE 


Explanation: One of the following conditions exists: 


¢ The second argument of the SUBSTR function is less than 1 
or greater than M. 


* The third argument of the SUBSTR function is an integer 
constant 0 or an expression whose value is less than 0 or 
greater than M—N-+1. 


M is the length of the first argument, if it is of fixed length, or M 
is the maximum length of the first argument, if it is of varying- 
length. N is the value of the second argument. 


System Action: The statement cannot be executed. 


Programmer Response: Ensure that the second and third 
arguments of the SUBSTR function have legal values according 
the above rules. 


-150 THE OBJECT OF THE INSERT, DELETE, OR 
UPDATE STATEMENT IS A VIEW FOR WHICH THE 
REQUESTED OPERATION IS NOT PERMITTED 


Explanation: The view named in the INSERT, UPDATE, or 
DELETE statement is defined in such a way that the requested 
insert, update, or delete operation cannot be performed upon it. 


Inserts into a view are prohibited if: 


¢ The view definition contains a join or a GROUP BY or 
HAVING clause. 


° The SELECT clause in the view definition contains the DIS- 
TINCT qualifier, an arithmetic expression, a string 
expression, a built-in function, or a constant. 


¢ Two or more columns of the view are derived from the 
same column. 


e A base table of the view contains a column that does not 
have a defined value and is not included in the view. 


Updates to a view are prohibited if: 


e The view definition contains a join or a GROUP BY or 
HAVING clause. 


¢ The SELECT clause in the view definition contains the DIS- 
TINCT qualifier or a function. 


Also, a given column in a view cannot be updated (that is, the 
values in that column cannot be updated) if the column is 
derived from an arithmetic expression, a constant, or a column 
that is part of the key of a partitioned index. 


Deletes against a view are prohibited if: 


¢ The view definition contains a join or a GROUP BY or 
HAVING clause. 


¢ The SELECT clause in the view definition contains the DIS- 
TINCT qualifier or a built-in function. 


System Action: The statement cannot be executed. No data 
was inserted, updated, or deleted. 


Programmer Response: The requested function cannot be per- 
formed on the view. Refer to Chapter 5 of SQL Reference for 
further information regarding inserting, deleting, and updating 
views. 


-151 THE UPDATE STATEMENT IS INVALID BECAUSE 
THE CATALOG DESCRIPTION OF COLUMN 
column-name INDICATES THAT IT CANNOT BE 


UPDATED 


Explanation: The specified column cannot be updated due to 
one of the following: 


* The object table is partitioned (that is, resides in a parti- 
tioned table space) and the column is included in the parti- 
tioning key. 


* The object table is a view and the specified column is 
defined (in the definition of the view) in such a way that it 
cannot be updated. 


¢ The object table is a catalog table. 


The values for columns occurring in the partitioning key of a 
partitioned table cannot be updated. 


Individual columns in a view cannot be updated for one of the 
following reasons: 


¢ The column is derived from an SQL function, an arithmetic 
expression, or a constant. 


* The column is defined for a column that is in the parti- 
tioning key of a partitioned table. 


¢ The column is defined for a column of an underlying view 
that cannot be updated. 


System Action: The statement cannot be executed. No data 
was updated in the object table or view. 


Programmer Response: The requested function is not sup- 
ported by DB2. Refer to Chapter 5 of SQL Reference for infor- 
mation regarding restrictions on the ability to update columns 
in partitioned tables and views. 


-151 — -158 


-153 THE CREATE VIEW STATEMENT DOES NOT 


INCLUDE A REQUIRED COLUMN LIST 


Explanation: You must specify a list of column names if the 
result table of the subselect has duplicate column names or an 
unnamed column (a column derived from a constant, function, 
or expression). 


System Action: The statement cannot be executed. The speci- 
fied view was not created. “ 


Programmer Response: Correct the statement by providing a 
list of names for the columns of the view. Refer to Chapter 5 of 
SQL Reference for information about the syntax of the CREATE 
VIEW statement. 


-154 THE CREATE VIEW FAILED BECAUSE THE VIEW 
DEFINITION CONTAINS A UNION, A UNION ALL, 


OR A REMOTE OBJECT 


Explanation: The view defined in the CREATE VIEW statement 
contains a UNION, a UNION ALL, or a remote object. DB2 
cannot create views containing unions or a remote object. 


System Action: The CREATE VIEW statement cannot be exe- 
cuted. The specified view is not created. 


Programmer Response: Refer to Chapter 5 of SQL Reference 
for information about restrictions on the definitions for views. 


-156 THE STATEMENT DOES NOT IDENTIFY A TABLE 


Explanation: The statements ALTER TABLE, DROP TABLE, and 
LOCK TABLE apply only to tables. Indexes can be defined only 
on tables. 


System Action: The statement cannot be executed. The speci- 
fied view or remote object was not altered, dropped, or locked, 
or the index was not created. 


Programmer Response: Verify that the proper name was spec- 
ified in the statement. 


ONLY A TABLE NAME CAN BE SPECIFIED IN A 
FOREIGN KEY CLAUSE. object-name IS NOT THE 
NAME OF A TABLE. 


-157 


Explanation: The indicated object was identified in a FOREIGN 
KEY clause of a CREATE or ALTER TABLE statement. A 
FOREIGN KEY clause must identify a table. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement to specify a 
table name in the foreign key clause. 


-158 THE NUMBER OF COLUMNS SPECIFIED FOR THE 
VIEW IS NOT THE SAME AS THE NUMBER OF 


COLUMNS SPECIFIED BY THE SELECT CLAUSE 


Explanation: The number of column names specified for a view 
in a CREATE VIEW statement must equal the number of ele- 
ments (column names, SQL functions, expressions, etc.) speci- 
fied in the following AS SELECT clause. 


System Action: The statement cannot be executed. The speci- 
fied view was not created. 


Programmer Response: Correct the syntax of the statement to 
specify a column name for each column in the view to be 
created. 


SQL Return Codes 29 


-159 — -181 


-159 DROP OR COMMENT ON token IDENTIFIES A(N) 


token RATHER THAN A(N) token 


Explanation: The object specified in the DROP VIEW statement, 
DROP ALIAS statement, or COMMENT ON ALIAS statement 
identifies a table instead of a view or an alias. 


The DROP VIEW statement can have only a view as its object. 
The DROP ALIAS or COMMENT ON ALIAS statement can have 
only an alias as its object. You must use the DROP TABLE 
statement to drop a table that is neither a view nor an alias. 
You must use the COMMENT ON TABLE statement to comment 
on a table. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the DROP VIEW, DROP ALIAS, 
or COMMENT ON ALIAS statement so that the view name or the 
alias name is specified correctly (with the proper qualifier). If 
you intended to drop or comment on the specified table, use the 
DROP TABLE or COMMENT ON TABLE statement. 


-160 THE WITH CHECK OPTION CANNOT BE USED FOR 


THE SPECIFIED VIEW 


Explanation: The WITH CHECK OPTION does not apply to a 
view definition under either of the following circumstances: 


° The view is defined as 'read-only' (for example, the view is 
defined on more than one base table or other view). 


¢ The SELECT statement of the view contains a subselect, a 
GROUP BY or HAVING clause, or the DISTINCT keyword. 


System Action: The statement cannot be executed. The speci- 
fied view was not created. 


Programmer Response: Refer to Chapter 5 of SQL Reference 
for rules regarding use of the WITH CHECK OPTION in view 
definitions. 


-161 THE INSERT OR UPDATE IS NOT ALLOWED 
BECAUSE A RESULTING ROW DOES NOT 
SATISFY THE VIEW DEFINITION 


Explanation: The WITH CHECK OPTION applies to the view that 
is the object of the INSERT or UPDATE statement. Conse- 
quently, all attempts to insert or update rows in that view are 
checked to ensure that the results will conform to the view defi- 
nition. 


System Action: The statement cannot be executed. No inserts 
or updates were performed, and the contents of the object view 
(and underlying base table) remain unchanged. 


Programmer Response: Examine the view definition to deter- 
mine why the requested INSERT or UPDATE was rejected. Note 
that this may be a data-dependent condition. 


-164 auth-id1 DOES NOT HAVE THE PRIVILEGE TO 


CREATE A VIEW WITH QUALIFICATION authori- 
zation ID : 


Explanation: The authorization ID ‘auth-id' does not have the 
authority necessary to create views with qualifiers other than 
its own authorization ID. Specifically, the attempt to create a 
view with qualifier ‘authorization ID' is rejected. 


System Action: The statement cannot be executed. The speci- 
fied view was not created. 


Programmer Response: Do not attempt to create views with 
other than your own ID as a qualifier. Only an authorization ID 
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that holds 'SYSADM' authority can create views for other 
authorization IDs. 


-170 THE NUMBER OF ARGUMENTS SPECIFIED FOR 
function-name IS INVALID 


Explanation: An SQL statement includes the scalar function 
'function-name' with either too many or too few arguments. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement. Refer to 
Chapter 4 of SQL Reference for information about the number of 
arguments required by the scalar function 'function-name'. 


-171 THE DATA TYPE, LENGTH, OR VALUE OF ARGU- 
MENT nn OF function-name IS INVALID 


Explanation: Either the data type, the length or the value of 
argument 'nn' of scalar function ‘function-name' is incorrect. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement. Refer to 
Chapter 4 of SQL Reference for rules for each argument of the 
scalar function 'function-name'. 


-180 THE STRING REPRESENTATION OF A DATETIME 
VALUE HAS INVALID SYNTAX 


Explanation: The string representation of a datetime value 
does not conform to the syntax for the specified or implied data 
type. 


System Action: The statement cannot be executed. 


Programmer Response: Check that the datetime value con- 
forms to the syntax for the data type it represents. 


-181 THE STRING REPRESENTATION OF A DATETIME 
VALUE IS NOT A VALID DATETIME VALUE 


Explanation: The string representation of a datetime is not in 
the acceptable range. The proper ranges for datetime values 
are as follows: 


Datetime Numeric Range 
Years 0001 to 9999 
Months ito 12 
Days 

April, June, September, 1 to 30 


November (months 4, 6, 9, 11) 

February (month 2) 1 to 28° 
January, March, May, July, 1 to 31 
August, October, December 

(months 1, 3, 5, 7, 8, 10, 12) 


Hours 0 to 24t 
Minutes 0 to 59 
Seconds 0 to 59 
Microseconds 0 to 999999 
Note: 


“Except leap years, when the proper range is 1 to 29. 


t if the hour is 24, the other parts of the time value are zeros. If 
the time format is USA, the hour cannot be greater than 12. 


System Action: The statement cannot be executed. 


Programmer Response: Check whether the value is within the 
valid range. 


-182 AN ARITHMETIC EXPRESSION WITH A DATETIME 
VALUE IS INVALID 


Explanation: The specified arithmetic expression contains an 
improperly used datetime value or labeled duration. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the indicated arithmetic 
expression. 


-183 AN ARITHMETIC OPERATION ON A DATE OR 
TIMESTAMP HAS A RESULT THAT IS NOT WITHIN 
THE VALID RANGE OF DATES 


Explanation: The result of an arithmetic operation is a date or 
timestamp that is not within the valid range of dates which are 
between 0001-01-01 and 9999-12-31. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the SQL statement to see if 
the cause of the problem can be determined. The problem may 
be data-dependent, in which case it will be necessary to 
examine the data that was processed at the time the error 
occurred. 


-184 AN ARITHMETIC EXPRESSION WITH A DATETIME 
VALUE CONTAINS A PARAMETER MARKER 


Explanation: The specified arithmetic expression contains a 
parameter marker improperly used with a datetime value. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the indicated arithmetic 
expression. 


“185 THE LOCAL FORMAT OPTION HAS BEEN USED 
WITH A DATE OR TIME AND NO LOCAL EXIT HAS 
BEEN INSTALLED 


Explanation: The local format option has been used with a 
datetime value and no datetime exit has been installed. This 
may occur if the LOCAL DATE LENGTH or LOCAL TIME LENGTH 
on the installation Application Programming Defaults Panel 
indicated that an exit for datetime was supplied, but in fact the 
exit supplied by DB2 was not replaced. This may also occur if 
the datetime exit was replaced and the corresponding LOCAL 
DATE LENGTH or LOCAL TIME LENGTH on the Instatlation 
Application Programming Defaults Panel was not set to a non- 
zero value. 


System Action: The statement cannot be executed. 


Programmer Response: Contact the system programmer about 
installation of the date or time exit. 


-186 THE LOCAL DATE LENGTH OR LOCAL TIME 
LENGTH HAS BEEN INCREASED AND EXECUTING 
PROGRAM RELIES ON THE OLD LENGTH 


Explanation: The local format option has been used with a 
datetime value and DB2 has discovered that the datetime exit 
routine has been changed to produce a longer local format. 


System Action: The statement cannot be executed. 


Programmer Response: ifthe statement receiving this error is 
embedded in the application program, then a REBIND command 
must be issued for the application plan. If the statement was 
dynamic SQL, then the statement may be re-entered. 


-182 — -204 


-187 A REFERENCE TO A CURRENT DATE/TIME 
SPECIAL REGISTER IS INVALID BECAUSE THE 
MVS TOD CLOCK IS BAD OR THE MVS PARMTZ 
IS OUT OF RANGE 


Explanation: DB2 has encountered an invalid time-of-day 
(TOD) clock. The user referenced one of the special registers: 
CURRENT DATE, CURRENT TIME, CURRENT TIMESTAMP, or 
CURRENT TIMEZONE. If the user referenced CURRENT 
TIMEZONE, the MVS parameter PARMTZ was out of range. 


System Action: The statement cannot be executed. 


Programmer Response: For CURRENT TIMEZONE, check that 
the MVS parameter PARMTZ is between —24 and +24 hours. 
For the other CURRENT special registers, check that the MVS 
TOD clock has been set correctly. 


-198 THE OPERAND OF THE PREPARE OR EXECUTE 
IMMEDIATE STATEMENT IS BLANK OR EMPTY 


Explanation: The operand (host variable or literal string) that 
was the object of the PREPARE or EXECUTE IMMEDIATE state- 
ment either contained all blanks or was an empty string. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the logic of the application 
program to ensure that a valid SQL statement is provided in the 
operand of the PREPARE or EXECUTE IMMEDIATE statement 
before that statement is executed. 


-199 ILLEGAL USE OF KEYWORD keyword. TOKEN 
token-list WAS EXPECTED 


Explanation: A syntax error was detected in the statement at 
the point where the keyword 'keyword' appears. 


As an aid to the programmer, a partial list of valid tokens is 
provided in SQLERRM as 'token-list'. This list assumes that 
the statement is correct up to that point, and only as many 
tokens are listed as will fit. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the statement in the area of 
the indicated keyword. A colon or SQL delimiter may be 
missing. 


-203 A REFERENCE TO COLUMN column-name IS 
AMBIGUOUS 


Explanation: Two or more of the tables specified in a FROM 
clause in the statement contain columns with the specified 
‘column-name'. The column name needs further qualification 
to establish which of the possible table-columns it is. 


System Action: The statement cannot be executed. 


Programmer Response: Qualify the ambiguous column name 
with a table name or correlation name. 


-204 name IS AN UNDEFINED NAME 


Explanation: The object identified by 'name' is not defined in 
the DB2 subsystem. This return code can be generated for any 
type of DB2 object. 


System Action: The statement cannot be executed. 


Programmer Response: Deiermine that the object name was 
correctly specified in the SQL statement (including any required 
qualifiers). Ifso, ensure that the object exists in the system 
before resubmitting the statement. 


SQL Return Codes 2-11 


-205 — -250 


-205 column-name IS NOT A COLUMN OF TABLE table- 


name 


Explanation: No column with the specified 'column-name' 
occurs in the table or view ‘table-name'. 


System Action: The statement cannot be executed. 


Programmer Response: Verify that the column and table 
names are specified correctly (including any required qual- . 
ifiers) in the SQL statement. 


-206 column-name IS NOT A COLUMN OF AN 
INSERTED TABLE, UPDATED TABLE, OR ANY 


TABLE IDENTIFIED IN A FROM CLAUSE 


Explanation: This return code is used to report one of these 
errors: 


e inthe case of an INSERT or UPDATE statement, the speci- 
fied column is not a column of the table or view that was 
specified as the object of the insert or update. 


¢ Inthe case of a SELECT or DELETE statement, the specified 
column is not a column of any of the tables or views identi- 
fied in a FROM clause in the statement. 


¢ There is a correlated reference in GROUP BY. 
¢ There is an unresolved qualified reference in HAVING. 


System Action: The statement cannot be executed. No data 
was retrieved, inserted, or updated. 


Programmer Response: Verify that the column and table 
names are specified correctly in the SQL statement. In the case 
of a SELECT statement, check to be sure that ail of the required 
tables were named in the FROM clause. 


-207 THE ORDER BY CLAUSE IS INVALID BECAUSE IT 
INCLUDES A COLUMN NAME BUT IT APPLIES TO 


THE RESULT OF A UNION OR UNION ALL 


Explanation: The ORDER BY clause in the statement is invalid 
because column names are specified in the ORDER BY list, and 
the statement contains a subselect with the UNION or UNION 
ALL operator. 


If an ORDER BY clause applies to the result of a UNION or | 
UNION ALL, integers (rather than column names) must be used 

in the ORDER BY list to identify the columns that are to be used 

in ordering the result table. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement by replacing the 
column names in the ORDER BY list with numeric column iden- 
tifiers. Refer to Chapter 5 of SQL Reference for information 
about restrictions on the syntax of ORDER BY clauses in state- 
ments that contain the UNION or UNION ALL operator. 


-208 THE ORDER BY CLAUSE IS INVALID BECAUSE 
COLUMN name IS NOT PART OF THE RESULT 


TABLE 


Explanation: The statement is invalid because a column 
('name') specified in the ORDER BY list does not appear in the 
result table (that is, is not specified in the SELECT-list). Only 
columns that are to appear in the result table can be used in 
ordering that result. 


System Action: The statement cannot be executed. 
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Programmer Response: Correct the syntax of the statement, 
either by adding the specified column to the result table, or 
deleting it from the ORDER BY clause. Refer to Chapter 5 of 
SQL Reference for information about restrictions on the use of 
the ORDER BY clause to order the result of an SQL SELECT. 


-219 THE REQUIRED EXPLANATION TABLE table-name 


DOES NOT EXIST 


Explanation: The EXPLAIN statement assumes the existence of 
the explanation table and it is not defined in the DB2 subsystem 
as a base table. Refer to Chapter 5 of SQL Reference for more 
information. 


System Action: The statement cannot be executed. 


Programmer Response: Determine whether the required 
explanation table does exist. If not, create the required table. 


-220 THE COLUMN column-name IN EXPLANATION 


TABLE table-name IS NOT DEFINED PROPERLY 


Explanation: An error occurred during the insertion of a row 
into the explanation table. The table is improperly defined for 
the following reasons: 


e Acolumn is missing. 
¢ Coljiumns are defined in the wrong order. 
e The table contains an extra column. 


¢ Acolumn description is invalid because of its name, data 
type, length, or null attributes. 


System Action: The statement cannot be executed. The expla- 
nation information is not generated. 


Programmer Response: Correct the definition of the required 
explanation table. Refer to Chapter 5 of SQL Reference for 
information on defining an explanation table. 


-221 “SET OF OPTIONAL COLUMNS” IN EXPLANATION 
TABLE table-name IS INCOMPLETE. OPTIONAL 


COLUMN column-name IS MISSING 


Explanation: The EXPLAIN statement assumes the required 
explanation table is defined properly. The optional column indi- 
cated is not defined in the indicated explanation table. 
PLAN-TABLE can have none or all of the three optional columns 
(PREFETCH, COLUMN-FN-EVAL, MIXOPSEQ). However, an 
error occurred during the insertion of rows into the 
PLAN-TABLE because the optional column indicated is not 
defined. 


System Action: The explanation information is not generated. 


Programmer Response: Correct the definition of the required 
explanation table to include all three optional columns or 
remove the existing optional columns. 


~250 THE LOCAL LOCATION NAME IS NOT DEFINED 
WHEN PROCESSING A THREE-PART OBJECT 


NAME 


Explanation: A three-part object name (table, view, or alias) 
cannot be used until the focal location name is defined. 


System Action: Install or reinstall the DB2 distributed data 
facility (DDF) with a registered location name for local DB2. 


Programmer Response: Define the loca! location name and 
then retry the function. 





-251 TOKEN name IS NOT VALID 


Explanation: A location name cannot contain alphabetic 
extenders. (The standard alphabetic extenders in the United 
States are #, @, $.) 


System Action: The statement cannot be executed 


Programmer Response: Correct the location name. 


-301 THE VALUE OF INPUT HOST VARIABLE NUMBER 


position-number CANNOT BE USED AS SPECIFIED 
BECAUSE OF ITS DATA TYPE 


Explanation: The input host variable in the input SQLDA whose 
entry number is indicated by 'position-number', could not be 
used as specified in the statement because its data type is 
incompatible with the requested function. 


System Action: The statement cannot be executed. 


Programmer Response: Verify that the data type of the indi- 
cated input host variable in the statement is compatible with the 
manner in which it is used. 


-302 THE VALUE OF INPUT VARIABLE NUMBER 
position-number IS INVALID OR TOO LARGE FOR 
THE TARGET COLUMN 


Explanation: The value of the input host variable, whose entry 
in the input SQLDA is indicated by 'position-number', was 
found to be invalid or to be too large to fit in the corresponding 
column of the table. One of the following has occurred: 


* The column is defined as string and the host variable con- 
tains a string that is too long for the column. 


* The column is defined as numeric and the host variable 
contains a numeric value too large for the definition of the 
column. 


¢ The host variable is defined as decimal, but contains bad 
decimal data. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the application program. 
Check the coiumn type and length of the value or the data type 
and contents of input host variable 'position-number’. Ensure 
that the value of the host variable will fit in the column or con- 
tains valid decimal data. Vatid decimal data is a System/370 
packed decimal number. 


-303 A VALUE CANNOT BE ASSIGNED TO OUTPUT 


HOST VARIABLE NUMBER position-number 
BECAUSE THE DATA TYPES ARE NOT COMPA- 
RABLE 


Explanation: A FETCH or SELECT into the output host variable, 
whose entry in the output SQLDA is indicated by 
'position-number', could not be performed because the data 
type of the variable was not compatible with the data type of the 
corresponding SELECT-list element. The output host variable 
and the corresponding SELECT-list element must fal! in one of 
the following categories: 


¢ Both values must be numbers. 
¢ Both values must be character strings. 
¢ Both values must be graphic strings. 


in addition, for datetime, and timestamp values, the host vari- 
able must be a character string variable with a proper length. 


System Action: The FETCH or SELECT cannot be executed. No 
data was retrieved. 


-251 — -312 


Programmer Response: Verify that table definitions are 
current, and that the host variable has the proper data type. 


-304 A VALUE WITH DATA TYPE data-type1 CANNOT 
BE ASSIGNED TO A HOST VARIABLE BECAUSE 
THE VALUE IS NOT WITHIN THE RANGE OF THE 
HOST VARIABLE IN POSITION position-number 
WITH DATA TYPE data-type2 


Explanation: A FETCH or SELECT into a host variable list or 
structure, position number 'position-number' failed because 
the host variable having data type 'data-type2' was not large 
enough to hold the retrieved value having data type 
'data-type1'. 


System Action: The statement cannot be executed. No data 
was retrieved. If the statement was a FETCH then the CURSOR 
remains open. 


Programmer Response: Verify that table definitions are 
current, and that the host variable has the proper data type. 
See the explanation for SQL return code -405 for ranges of SQL 
data types. 


-305 THE NULL VALUE CANNOT BE ASSIGNED TO 
OUTPUT HOST VARIABLE NUMBER position- 
number BECAUSE NO INDICATOR VARIABLE IS 
SPECIFIED 


Explanation; A FETCH or embedded SELECT operation 
resulted in the retrieval of a null value to be inserted into the 
output host variable, designated by entry number 
'position-number' of the output SQLDA, for which no indicator 
variable was provided. An indicator variable must be supplied 
if a column returns a null value. 


System Action: The statement cannot be executed. No data 
was retrieved. 


Programmer Response: Examine the definition of the table that 
is the object of the FETCH or SELECT, and correct the applica- 
tion program so provide indicator variables for all host vari- 
ables into which values from columns that can contain null 
values are retrieved. 


-309 A PREDICATE IS INVALID BECAUSE A REFER- 
ENCED HOST VARIABLE HAS THE NULL VALUE 


Explanation: The statement could not be processed because a 
host variable appearing in a predicate such as 

column-name = host-variable 

had the NULL value. Such a predicate is not permitted in the 


case in which the host variable contains the NULL value—even 
though the object column may in fact contain nulls. 


System Action: The statement cannot be executed. 


Programmer Response: The implied function is not supported 
by DB2. Refer to Chapter 3 of SQL Reference for information 
about restrictions on the use of NULL values for host variables. 


312 UNDEFINED OR UNUSABLE HOST VARIABLE 
variable-name 


Explanation: The host variable ‘variable-name' appears in the 
SQL statement, but either no declaration for a variable of that 
name appears in the application program, or the attributes are 
improper for the specified usage. 


System Action: The statement cannot be executed. 


Programmer Response: Verify that the variable name is 
spelled properly in the SQL statement, that the application 


SQL Return Codes 2-13 


-313 — -408 


program contains a declaration for that variable, and that the 
attributes of the variable are compatible with its use in the 
statement. 


-313 THE NUMBER OF HOST VARIABLES SPECIFIED IS 


NOT EQUAL TO THE NUMBER OF PARAMETER 
MARKERS 


Explanation: The number of host variables specified in the 
EXECUTE or OPEN statement is not the same as the number of 
parameter markers (question marks) appearing in the prepared 
SQL statement. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the application program so 
that the number of host variables specified in the EXECUTE or 
OPEN statement is the same as the number of parameter 
markers appearing in the prepared SQL statement. 


~314 THE STATEMENT CONTAINS AN AMBIGUOUS 


HOST VARIABLE REFERENCE 


Explanation: A host variable used in the statement has been 
defined more than once in this application program causing 
confusion as to which host variable defined should be used. 


System Action: The statement cannot be executed. 


Programmer Response: Make the host variable unique or use 
qualifications to indicate which host variable definition is to be 
used. 


-401 THE OPERANDS OF AN ARITHMETIC OR COM- 


PARISON OPERATION ARE NOT COMPARABLE 


Explanation: An arithmetic operation appearing within the SQL 
statement has a mixture of numeric and nonnumeric operands, 
or the operands of a comparison operation are not compatible. 


System Action: The statement cannot be executed. 


Programmer Response: Check the data types of all operands 
to ensure that their data types are comparable and compatible 
with their usage in the statement. 


if all the operands of the SQL statement are correct, then, ifa 
view is being accessed, check the data types of all the oper- 
ands in the view definition. 


-402 AN ARITHMETIC FUNCTION OR OPERATOR 
arith-fop IS APPLIED TO CHARACTER OR 
DATETIME DATA 


Explanation: A nonnumeric operand has been specified for the 
arithmetic function or operator ‘arith-fop'. 


System Action: The statement cannot be executed. 


Programmer Response: Examine and correct the syntax of the 
SQL statement such that all operands of the specified function 
or operator are numeric. 


~404 THE UPDATE OR INSERT STATEMENT SPECIFIES 


A STRING THAT IS TOO LONG column-name 


Explanation: An INSERT or UPDATE statement specifies a 
value that is longer than the maximum-length string that can be 
stored in the indicated column. 


System Action: The statement cannot be executed. 


Note: ‘column-name' may or may not be returned in SQLCA, 


. depending on the syntax of the INSERT or UPDATE statement. 


2-14 DB2 Messages and Codes 


Programmer Response: Check the length of the object column, 
and correct the program or SQL statement so that the length of 
the insert or update string does not exceed that maximum. 


-405 THE NUMERIC LITERAL literal CANNOT BE USED 
AS SPECIFIED BECAUSE IT IS OUT OF RANGE 


Explanation: The specified numeric literal is not in the proper 
range. 


The proper ranges for SQL values are as follows: 


e 5.4E—79 to 7.2E+75 for FLOAT values 

e —999999999999999 to 999999999999999 for DECIMAL values 
© ~—2147483648 to 2147483647 for INTEGER values 

¢ ~32768 to +32767 for small integer (SMALLINT) values. 


System Action: The statement cannot be executed. 


Programmer Response: The value of the literal should be 
reduced to the appropriate size for this data type. Perhaps you 
left out a decimal point. 


-406 A CALCULATED OR DERIVED NUMERIC VALUE IS 
NOT WITHIN THE RANGE OF ITS OBJECT 
COLUMN 


Explanation: A value derived or calculated during processing 
of the SQL. statement was outside the range of the data type of 
its object column. This problem might have arisen because 
either the values occurring in the object column were out of 
range, or the SQL operation performed was not appropriate for 
the values in the object column. 


System Action: The statement cannot be executed. 


Programmer Response: See the explanation of SQL return 
code -405 for allowed ranges for numeric data types. 


-407 AN UPDATE OR INSERT VALUE IS NULL, BUT THE 
OBJECT COLUMN column-name CANNOT 
CONTAIN NULL VALUES 


Explanation: The update or insert value was NULL, but the 
object column was declared as NOT NULL in the table defi- 
nition. 


Consequently: 


e Null values cannot be inserted into that column. 
e¢ Values in that column cannot be set to NULL by an update. 


System Action: The statement cannot be executed. 


Note: 'column-name' may or may not be returned in SQLCA, 
depending on the syntax of the SQL statement in which the 
error was detected. 


Programmer Response: Examine the definition of the object 
table to determine which coiumns of the table have the NOT 
NULL attribute, and correct the SQL statement accordingly. 


-408 AN UPDATE OR INSERT VALUE IS NOT COMPA- 
RABLE WITH THE DATA TYPE OF ITS OBJECT 
COLUMN column-name 


Explanation: The data type of the value to be inserted into or 
set in the column 'column-name' by an INSERT or UPDATE 
statement is incompatible with the declared data type of that 
column. Both must be numeric or both must be graphic string; 
or both must be either: 


* Dates or character 
e Times or character 
e Timestamps or character. 


However, dates, times, or timestamps cannot be assigned to a 
character column that has a field procedure. 


System Action: The statement cannot be executed. No data 
was inserted or updated. 


Programmer Response: Examine the current definition for the 
object table, and ensure that the host variable or literal value 
assigned to the specified column has the proper data type. 


-409 INVALID OPERAND OF A COUNT FUNCTION 


Explanation: As specified in the SQL statement, the operand of 
the COUNT function does not conform to the rules of SQL 
syntax. A common error is a column name without DISTINCT. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the syntax and resubmit the 
statement. Refer to Chapter 4 of SQL Reference for information 
about the proper form for the operands of a COUNT function. 


-410 THE FLOATING POINT LITERAL literal CONTAINS 


MORE THAN 30 CHARACTERS 


Explanation: The specified floating point literal is more than 30 
characters in length. A floating point literal has a maximum 
length of 30 characters. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the indicated literal. 


-411 THE CURRENT DATETIME, CURRENT SQLID OR 


USER KEYWORD CAN NOT BE USED AS SPECI- 
FIED 


Explanation: The CURRENT datetime, CURRENT SQLID, or 
USER keyword appearing within an SQL statement is applied in 
a way that is invalid for its data type: 


¢ CURRENT SQLID or USER has an implied data type of 
CHAR(8). 

¢ CURRENT DATE has an implied data type of DATE. 

¢ CURRENT TIME has an implied data type of TIME. 

¢ CURRENT TIMESTAMP has an implied data type of 
TIMESTAMP. 

¢ CURRENT TIMEZONE has an implied data type of 
DECIMAL(6,0). 


The CURRENT SQLID is not valid in an SQL statement that 
accesses remote data. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the attributes of the implied 
data type to determine the invalid use. It may be necessary to 
modify either the syntax of the SQL statement or the logic of the 
application program. 


-412 THE SELECT CLAUSE OF A SUBQUERY SPECI- 


FIES MULTIPLE COLUMNS 


Explanation: In the context in which it was used in the SQL 
statement, the subquery can have only one column specified in 
its SELECT clause. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the syntax of the SQL state- 
ment. Refer to Chapter 5 of SQL Reference for information 
about restrictions on the syntax for subqueries. 


-409 — -417 


-414 THE NUMERIC OR DATETIME COLUMN column- 
name IS SPECIFIED IN A LIKE PREDICATE 


Explanation: A column ('column-name') with a numeric data 
type or date/time data type was specified in a LIKE predicate. 
Coiumns specified in a LIKE predicate must be character or 
graphic string columns. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the definition for the speci- 
fied column in the object table to verify that the column name 
(with any required qualifiers) was specified correctly. Columns 
with a numeric or date/time data type cannot appear as oper- 
ands in a LIKE or NOT LIKE predicate. 


-415 THE CORRESPONDING COLUMNS, column- 
number, OF THE OPERANDS OF A UNION OR A 
UNION ALL DO NOT HAVE COMPARABLE 
COLUMN DESCRIPTIONS 


Explanation: The column descriptions of corresponding 
columns of the operands of a UNION or UNION ALL must be 
comparable. The columns of ordinality 'column-number' of the 
operands in this UNION or UNION ALL do not satisfy this 
requirement. For columns to be comparable, they must both be 
either numeric, character, graphic, date, time, or timestamp. 
They cannot be a mixture of these groups. If corresponding 
columns have field procedures, they must both have the same 
field procedure. 


System Action: The statement cannot be executed. 


Programmer Response: Check the data types of the specified 
columns and correct the UNION or UNION ALL statement so that 
all corresponding columns have comparable column 
descriptions. 


-416 AN OPERAND OF A UNION CONTAINS A LONG 
STRING COLUMN 


Explanation: The UNION specified in the SQL statement could 
not be performed because one of the tables participating in the 
union contains a long string column (for example, a VARCHAR 
column with length greater than 254). The operands of a UNION 
cannot contain long string columns. 


System Action: The statement cannot be executed. 


Programmer Response: The implied function is not supported 
by DB2. Refer to Chapter 3 of SQL Reference for information 
about restrictions on the manipulation of long string columns. 


-417 A STATEMENT STRING TO BE PREPARED 
INCLUDES PARAMETER MARKERS AS THE OPER- 
ANDS OF THE SAME OPERATOR 


Explanation: The statement string specified as the object of a 
PREPARE contains a predicate or expression where parameter 
markers have been used as operands of the same operator—for 
example: 


2>? 
This syntax is not permitted. 
System Action: The statement cannot be executed. 


Programmer Response: Correct the logic of the application 
program so that this syntax error does not occur. Refer to 
Chapter 5 of SQL Reference for information about the proper 
usage of parameter markers within SQL statements to be pre- 
pared. 
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-418 — -507 


-418 A STATEMENT STRING TO BE PREPARED CON- 


TAINS AN INVALID USE OF PARAMETER 
MARKERS 


Explanation: Parameter markers cannot be used in the 
SELECT list, as the sole argument of a scalar function, or ina 
concatenation operation. Parameter markers cannot be used in 
the string expression of an EXECUTE IMMEDIATE SQL state- 
ment. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the logic of the application 
program so that this error does not occur. Refer to Chapter 5 of 
SQL Reference for information about the proper usage of 
parameter markers within SQL statements and for EXECUTE 
IMMEDIATE SQL statement restrictions. 


“419 THE DECIMAL DIVIDE OPERATION IS INVALID 


BECAUSE THE RESULT WOULD HAVE A NEGA- 
TIVE SCALE 


Explanation: The decimal division is invalid because it will 
result in a negative scale. 


The formula used internally to calculate the scale of the result 
for decimal division is 


Scale of result = 15-np+ns-ds, 


where 'np' is the precision of the numerator, 'ns' is the scale 
of the numerator, and 'ds' is the scale of the denominator. 


System Action: The statement cannot be executed. No data 
was retrieved, updated, or deleted. 


Programmer Response: Examine the precision and scale of all 
columns that may have participated in a decimal division. Note 
than an integer or small integer value may have been con- 
verted to decimal for this calculation. 


-421 THE OPERANDS OF A UNION OR UNION ALL DO 


NOT HAVE THE SAME NUMBER OF COLUMNS 


Explanation: The operands of a UNION or UNION ALL must 
have the same number of columns. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the SQL statement so that 
there are exactly the same number of columns in each operand. 


-501 THE CURSOR IDENTIFIED IN A FETCH OR CLOSE 


STATEMENT IS NOT OPEN 
Explanation: The application program attempted to either: 
1. FETCH using a cursor, or 
2. CLOSE a cursor 
at a time when the specified cursor was not open. 
System Action: The statement cannot be executed. 


Programmer Response: Check for a previous SQL return code 
that may have closed the cursor. Commit and rollback oper- 
ations close cursors. SQL codes -404, -652, -679, -901, -904, 
-909, -910, -911, and -913 will force the cursor to close. After the 
cursor is closed, any fetches or close cursor statements will 
receive this SQL code ({-501). 
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If no previous SQL codes have been issued, correct the logic of 
the application program to ensure that the cursor is open at the 
time the FETCH or CLOSE statement is executed. 


-502 THE CURSOR IDENTIFIED IN AN OPEN STATE- 
MENT IS ALREADY OPEN 


Explanation: The application program attempted to execute an 
OPEN statement for a cursor that was already open. 


System Action: The statement cannot be executed. The cursor 
was unchanged (that is, it was not 'reopened'). 


Programmer Response: Correct the logic of the application 
program to ensure that it does not attempt to execute an. OPEN 
statement for a cursor that is already open. 


-503 A COLUMN CANNOT BE UPDATED BECAUSE IT IS 
NOT IDENTIFIED IN THE UPDATE CLAUSE OF THE 
SELECT STATEMENT OF THE CURSOR 


Explanation: The application program attempted to update 
(using a cursor) a value in a column of the object table that was 
not identified in the FOR UPDATE clause in the cursor declara- 
tion. 


Any column that is to be updated must be identified in the FOR 
UPDATE clause of the cursor declaration. 


System Action: The statement cannot be executed. No data 
was updated in the object table. 


Programmer Response: Correct the application program. If 
the column is to be updated, its name must be added to the 
FOR UPDATE clause of the cursor declaration. 


-504 THE CURSOR NAME cursor-name IS NOT 
DEFINED 


Explanation: Cursor 'cursor-name' was not declared in the 
application program before it was referenced. 


System Action: The statement cannot be executed. 


Programmer Response: Check the application program for 
completeness and for a possible spelling error in the cursor 
declaration. The declaration for a cursor must appear in an 
application program before statements that reference the 
cursor. 


-507 THE CURSOR IDENTIFIED IN THE UPDATE OR 
DELETE STATEMENT IS NOT OPEN 


Explanation: The application program attempted to execute an 
UPDATE or DELETE WHERE CURRENT OF cursor statement at a 
time when the specified cursor was not open. 


System Action: The statement cannot be executed. No update 
or delete was performed. 


Programmer Response: Check for a previous SQL return code 
that may have closed the cursor. SQL codes -404, -652, -679, 
~901, -904, -909, -910, -911, and -913 will force the cursor to 
close. After the cursor is closed, any fetches or close cursor 
statements will receive SQL code -501. Any updates or deletes 
will receive this SQL code (-507). Correct the logic of the appli- 
cation program to ensure that the specified cursor is in fact 
open at the time the UPDATE or DELETE statement is executed. 








-508 THE CURSOR IDENTIFIED IN THE UPDATE OR 
DELETE STATEMENT IS NOT POSITIONED ON A 


ROW 


Explanation: The application program attempted to execute an 
UPDATE or DELETE WHERE CURRENT OF cursor statement at a 
time when the specified cursor was not positioned on a row of 
the object table. The cursor must be positioned on the row that 
is to be updated or deleted. 


Note that the cursor is no longer positioned on a row if the row 
is deleted or an index column of the row is updated by another 
cursor in the same application program. 


System Action: The statement cannot be executed. No data 
was updated or deleted. 


Programmer Response: Correct the logic of the application 
program to ensure that the cursor is correctly positioned on the 
intended row of the object table before the UPDATE or DELETE 
statement is executed. Note that the cursor is not positioned on 
a row if FETCH returned an SQLCODE = 100. 


THE TABLE IDENTIFIED IN THE UPDATE OR 
DELETE STATEMENT IS NOT THE SAME TABLE 
DESIGNATED BY THE CURSOR 


-509 


Explanation: The application program attempted to execute an 
UPDATE or DELETE WHERE CURRENT OF cursor statement 
where the table named in that statement did not match the 
name of the table specified in the dectaration for that cursor. 


System Action: The statement cannot be executed. The update 
or delete was not performed. 


Programmer Response: Correct the application program to 
ensure that the table identified in the UPDATE or DELETE state- 
ment is the same table identified in the declaration for the 
cursor. 


-510 THE TABLE DESIGNATED BY THE CURSOR OF 
THE UPDATE OR DELETE STATEMENT CANNOT 


BE MODIFIED 


Explanation: The application program attempted to execute an 
UPDATE or DELETE WHERE CURRENT OF cursor statement 

against a table or view that cannot be updated or deleted. This 
can occur for a delete from a read-only view or for an update in 
which the cursor was not defined with the FOR UPDATE clause. 


This error code is also returned when the table exists at a 
remote location and DB2 has employed block fetching because 
you explicitly declared the CURSOR FOR FETCH ONLY. 


System Action: The statement cannot be executed. No data 
was updated or deleted in the object table. 


Programmer Response: The requested UPDATE or DELETE 
cannot be performed. Refer to SQL Reference for information 
about restrictions on using UPDATE and DELETE operations 
against views. 


R 


For a remote table, modify the DECLARE CURSOR and then 
rebind the PLAN. 


-508 — -516 


-511 THE FOR UPDATE CLAUSE CANNOT BE SPECI- 
FIED BECAUSE THE TABLE DESIGNATED BY THE 


CURSOR CANNOT BE MODIFIED 


Explanation: The result table of the SELECT statement cannot 
be updated. This can occur ifthe SELECT specifies more than 
one table or view in the FROM clause, if the SELECT list con- 
tains a built-in function or DISTINCT, or if the statement con- 
tains an ORDER BY or GROUP BY or HAVING clause. This can 
also occur if a view is specified in the FROM clause and the 
view cannot be updated. 


System Action: The statement cannot be executed. The speci- 
fied cursor remains undefined in the application program. 


Programmer Response: Updates cannot be performed on the 
result table as it is specified. Refer to Chapter 5 of SQL Refer- 
ence for information about restrictions on the updating of 
views. 


-512 STATEMENT REFERENCE TO REMOTE OBJECT IS 


INVALID 
Explanation: One of two conditions exists: 


¢ The statement refers to multiple locations. 
¢ The statement invalidly refers to a remote object. 


System Action: The statement cannot be executed. 


Programmer Response: Refer to SQL Reference for more 
information about using remote objects. 


-513 THE ALIAS alias-name MUST NOT BE DEFINED 


ON ANOTHER LOCAL OR REMOTE ALIAS 


Explanation: The object indicated by ‘alias-name' is a focal or 
remote alias. An alias is not allowed to be defined on a local 
alias, and it should not be defined on a remote alias. 


System Action: The statement cannot be executed. 


Programmer Response: Modify the SQL statement to ensure 
that all object references are to base tables or views. 


-514 THE CURSOR cursor-name IS NOT IN A PRE- 


PARED STATE 


Explanation: The application program has tried to use a 
cursor, 'cursor-name, ' that is not in a prepared state. The 
cursor is associated with a statement that either (1) has never 
been prepared, or (2) has been invalidated by a COMMIT or 
ROLLBACK (or the IMS/VS or CICS equivalent). 


System Action: The statement cannot be executed. 


Programmer Response: For case (1), ensure that you prepare 
the statement that is named in the DECLARE CURSOR state- 
ment for 'cursor-name' before you try to open the cursor. For 
case (2), either do not issue COMMIT or ROLLBACK until after 
you are finished using the cursor, or prepare the statement 
again after the COMMIT or ROLLBACK. 


-516 THE DESCRIBE STATEMENT DOES NOT IDENTIFY 


A PREPARED STATEMENT 


Explanation: An attempt was made to execute a DESCRIBE for 
a statement that had not been successfully prepared before- . 
hand. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the logic of the application 
program to ensure that a statement is properly prepared before 
a DESCRIBE of the statement is attempted. 
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-517 — -534 


-517 CURSOR cursor-name CANNOT BE USED 
BECAUSE ITS STATEMENT NAME DOES NOT 
IDENTIFY A PREPARED SELECT STATEMENT 


Explanation: The cursor 'cursor-name' could not be used as 
specified because the prepared statement named in the decla- 
ration for the cursor was not a SELECT statement. 


System Action: The statement cannot be executed. 


Programmer Response: Verify that the statement-name is 
specified correctly in the PREPARE statement and the 
DECLARE CURSOR statement for cursor 'cursor-name'. Alter- 
natively, correct the application program logic to ensure that 
only prepared SELECT statements are used in association with 
cursor declarations. 


-518 THE EXECUTE STATEMENT DOES NOT IDENTIFY 


A VALID PREPARED STATEMENT 
Explanation: One of the following conditions exists: 


¢ The statement named in the EXECUTE statement has not 
been prepared. 


e The statement named in the EXECUTE statement identifies 
a SELECT statement. 


¢ The statement named in the EXECUTE IMMEDIATE state- 
ment identifies a SELECT statement. 


System Action: The statement cannot be executed. 


Programmer Response: Ensure that you prepare the statement 
prior to EXECUTE. Also, ensure that the statement you prepare 
is not a SELECT statement. 


-519 THE PREPARE STATEMENT IDENTIFIES THE 
SELECT STATEMENT OF THE OPENED CURSOR 
cursor-name 


Explanation: The application program has attempted to 
PREPARE (actually, re-PREPARE) the SELECT statement for the 
specified cursor at a time when that cursor was already open. 


System Action: The statement cannot be executed. The cursor 
was not affected. 


Programmer Response: Correct the logic of the application 
program so that it does not attempt to re-PREPARE the SELECT 
statement for a cursor when that cursor is open. 


-530 THE INSERT OR UPDATE VALUE OF FOREIGN 


KEY constraint-name IS INVALID 


Explanation: An UPDATE or INSERT operation attempted to 
place a value in a foreign key of the object table; however, this 
value was not equal to some value of the primary key of the 
parent table. 


When a row is inserted into a dependent table, the insert value 
of a foreign key must be equal to the value of the primary key of 
some row of the parent table in the associated relationship. 


When the value of the foreign key is updated, the update value 
of a foreign key must be equal to the value of the primary key of 
some row of the parent table of the associated relationship. 


System Action: The UPDATE or INSERT statement cannot be 
executed. The object table is unchanged. 


Programmer Response: Examine the insert or update value of 
the foreign key first, and then compare it with each of the 
primary key values of the parent table to determine the cause 
of the problem. 
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-531 THE PRIMARY KEY IN A PARENT ROW CANNOT 
BE UPDATED BECAUSE !T HAS ONE OR MORE 
DEPENDENT ROWS IN A RELATIONSHIP 
constraint-name 


Explanation: An UPDATE operation attempted to update a 
primary key in the specified row of the object table; however, 
the primary key in the specified row had dependent rows asso- 
ciated with it. 


The value of a primary key in a parent row cannot be updated if 
the parent row has any dependent rows. 


System Action: The UPDATE statement cannot be executed. 
The object table is unchanged. 


Programmer Response: Examine the primary key of the object 
table and the foreign key of the dependent table to determine if 
the value of the specified row of the primary key should be 
changed. If this does not expose the problem, examine the con- 
tents of the object table and the dependent table to determine 
the cause of the problem. 


-532 THE RELATIONSHIP constraint-name RESTRICTS 
THE DELETION OF ROW WITH RID X'rid-number' 


Explanation: A DELETE operation attempted to delete a speci- 
fied parent row in the object table and all related descendant 
rows in the descendant tables. However, a delete rule of 
RESTRICT was specified for one or more descendant tabies. 


A row of the table cannot be deleted because it has a 
dependent in a relationship with a delete rule of RESTRICT or 
the deletion cascades to a row which is a dependent ina 
relationship with a delete rule of RESTRICT. 


System Action: The DELETE statement cannot be executed. 
The contents of the object table are unchanged. 


Programmer Response: Examine the delete rule for all 
descendant tables to determine the cause of the problem. The 
specific tables involved can be determined from the relation- 
ship 'constraint-name'. The specific descendant row is known 
by RID X'rid-number'. 


-533 INVALID MULTIPLE-ROW INSERT 


Explanation: An INSERT operation with a subselect attempted 
to insert multiple rows into a self-referencing tabie. 


The subselect of the INSERT operation should return no more 
than one row of data. 


System Action: The INSERT statement cannot be executed. 
The contents of the object tabie are unchanged. 


Programmer Response: Examine the search condition of the 
subselect to make sure that no more than one row of data is 
selected. 


-534 THE PRIMARY KEY CANNOT BE UPDATED 
BECAUSE OF MULTIPLE-ROW UPDATE 


Explanation: An UPDATE operation attempted to update a 
primary key on multiple rows of the object table. 


An UPDATE statement updating the primary key cannot be used 
to update more that one row of the object table. 


System Action: The UPDATE statement cannot be executed. 
The contents of the object table are unchanged. 


Programmer Response: Examine the search condition of the 
UPDATE statement to make sure that no more than one row of 
the object table is selected to be updated. 


-535 INVALID UPDATE OR DELETE WITH WHERE 


CURRENT OF 


Explanation: An UPDATE operation with WHERE CURRENT OF 
cannot be used to update a primary key of the object table, or a 
DELETE operation with WHERE CURRENT OF cannot be used to 
delete from a self-referencing table. 


System Action: The UPDATE or DELETE statement cannot be 
executed. The contents of the object table are unchanged. 


Programmer Response: Do not update a primary key with 
WHERE CURRENT OF in the UPDATE statement, or do not 
delete from a self-referencing table with WHERE CURRENT OF 
in the DELETE statement. 


-536 THE DELETE STATEMENT IS INVALID BECAUSE 
TABLE table-name CAN BE AFFECTED BY THE 


OPERATION 


Explanation: A DELETE operation with the indicated table ref- 
erenced in a subquery was attempted. 


If 'T' is the object table of the DELETE, the indicated table is 
one of the following: 


¢ A dependent of 'T' in a relationship with a delete rule of 
CASCADE or SET NULL 


e A dependent of another table in a relationship with a delete 
rule of CASCADE or SET NULL in which deletions from 'T' 
can cascade to that table. 


System Action: The DELETE statement cannot be executed. 
The contents of the object table are unchanged. 


Programmer Response: Do not attempt to reference a table in 
a subquery of a DELETE statement when the table can be 
affected by the DELETE statement. 


-537 THE PRIMARY KEY OR FOREIGN KEY CLAUSE 
IDENTIFIES COLUMN column-name MORE THEN 


ONCE 


Explanation: The code is used to report that the indicated 
column-name appears more than once in a PRIMARY KEY or 
FOREIGN KEY clause. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement to specify 
unique names for each column. 


-538 FOREIGN KEY name DOES NOT CONFORM TO 
THE DESCRIPTION OF THE PRIMARY KEY OF 


TABLE tabie-name 


Explanation: The code is used to report that the definition of 
the indicated foreign key does not conform to the description of 
the primary key of the indicated table. Either the keys do not 
have the same number of columns or their descriptions are not 
identical. The requirement for identical descriptions includes 
data type, length attribute, and field procedure. The name is 
the constraint-name specified in the FOREIGN KEY clause or, if 
a constraint-name was not specified, the first column-name 
specified in the clause. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement so that the 
description of the foreign key conforms to that of the primary 
key of the indicated table. 


-535 — -551 


-539 TABLE table-name DOES NOT HAVE A PRIMARY 


KEY 


Explanation: The code is used to report that the indicated 
table, which is nominated as a parent in a FOREIGN KEY 
clause, cannot be defined as a parent because it does not have 
a primary key. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement so that the table 
nominated as a parent in the FOREIGN KEY clause references a 
table with a primary key, or define a primary key for the table 
nominated as a parent. 


-540 THE DEFINITION OF TABLE table-name IS INCOM- 
PLETE BECAUSE IT DOES NOT HAVE A PRIMARY 


INDEX 


Explanation: The code is used to report that the reference to 
the indicated table is invalid because it has a primary key but 
no primary index. The reference is in a FOREIGN KEY clause 
or a SQL manipulative statement. 


System Action: The statement cannot be executed. 


Programmer Response: Define a primary index on the table 
before referencing it. 


-541 FOREIGN KEY name IS INVALID BECAUSE ITIS A 


DUPLICATE REFERENTIAL CONSTRAINT 


Explanation: The code is used to report that a referential con- 
straint cannot be defined because the indicated FOREIGN KEY 
clause defines the same foreign key and pareni table as 
another referential constraint. The name is the constraint name 
specified in the FOREIGN KEY clause or, if a constraint-name 
was not specified, the first column-name specified in the clause. 


System Action: The statement cannot be executed. 


Programmer Response: Remove the duplicated referential 
constraint from the statement. 


-542 column-name CANNOT BE A COLUMN OF A 
PRIMARY KEY BECAUSE IT CAN CONTAIN NULL 


VALUES 


Explanation: The code is used to report that a column identi- 
fied in a PRIMARY KEY clause is defined to allow null values. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement and rerun it. 


-551 auth-id DOES NOT HAVE THE PRIVILEGE TO 
PERFORM OPERATION operation ON OBJECT 


object-name 


Explanation: Authorization !D ‘auth-id' attempted to perform 
‘operation' on object 'object-name' without having been 
granted the proper authority to do so. This error might also 
occur if the specified object does not exist, if the object is a 
read-only view (for UPDATE or INSERT), or if ‘authorization ID' 
is trying to create a table or view with an authorization ID other 
than its own. Only if your authorization ID is SYSADM, DBADM, 
or DBCTRL can you create a table from an ‘authorization ID' 
other than your own. Only if your authorization ID is a SYSADM 
can you create a view from an ‘authorization ID' other than 
your own. 


lf this error occurs while DB2 is creating or altering a tabie 
involving referential constraints, this code reports that the user 
does not have the necessary ALTER privilege to perform a 
FOREIGN KEY, DROP FOREIGN KEY, or DROP PRIMARY KEY 


SQL Return Codes 2-19 


-552 — -558 


operation. The ‘object-name' identifies the object table of the 
CREATE or ALTER TABLE statement, not the table for which the 
user lacks the ALTER privilege. 


System Action: The statement cannot be executed. 


installation Action: 
lation. 


Check for an attempted authorization vio- 


Programmer Response: Ensure that ‘authorization ID' has 
been granted the authority to perform the desired operation, 
that the 'object-name' exists, and that ‘authorization ID' is not 
trying to create a table or view with a different authorization ID. 


-552 auth-id DOES NOT HAVE THE PRIVILEGE TO 


PERFORM OPERATION operation 


Explanation: Authorization ID 'auth-id' has attempted to 
perform the specified ‘operation’ without having been granted 
the authority to do so. 


System Action: The statement cannot be executed. 


Installation Action: Check for an attempted authorization vio- 
lation. 


Programmer Response: Ensure that the authorization ID has 
been granted the authority necessary to perform the desired 
operation. 


-553 auth-id SPECIFIED IS NOT ONE OF THE VALID 


AUTHORIZATION IDS 


Explanation: The authorization ID specified as the value of the 
‘authorization-id' or host variable in the SQL SET CURRENT 
SQLID statement is neither the user’s primary authorization ID 
nor one of the associated secondary authorization IDs. 


System Action: The SET CURRENT SQLID statement cannot be 
executed. The current SQL ID is not changed. 


Programmer Response: Correct the error in the statement or 
contact the security administrator to have the authorization ID 
defined for your use. 


-554 AN AUTHORIZATION ID CANNOT GRANT A PRIVI- 


LEGE TO ITSELF 


Explanation: An authorization !D has attempted to execute a 
GRANT statement in which that ID itself appears as one of the 
entries in the list of 'grantee' authorization IDs. 


An authorization ID cannot GRANT a privilege to itself. 


System Action: The statement cannot be executed. No privi- 
leges were granted. 


Programmer Response: Refer to Chapter 5 of SQL Reference 
for information about restrictions on the use of the GRANT 
statement. 


-555 AN AUTHORIZATION ID CANNOT REVOKE A PRIV- 


iLEGE FROM ITSELF 


Explanation: An authorization ID has attempted to execute a 
REVOKE statement in which that ID itself appears as one of the 
entries in the list of authorization IDs to be revoked. 


An authorization ID cannot REVOKE its own privilege. 


System Action: The statement cannot be executed. No privi- 
leges were revoked. 


2-20 DB2 Messages and Codes 


Programmer Response: Refer to Chapter 5 of SQL Reference 
for information about restrictions on the use of the REVOKE 
statement. 


A PRIVILEGE CANNOT BE REVOKED BECAUSE IT 
iS NOT POSSESSED BY authorization ID 


-556 


Explanation: The REVOKE statement would revoke a privilege 
from authorization ID 'auth-id'. This cannot be done because of 
one of the following: 


¢ The authorization ID does not possess the privilege. 


¢ The authorization ID was not granted the privilege by the 
revoker. 


¢ The authorization ID is the owner of the object being 
revoked. 


System Action: The statement cannot be executed. No privi- 
leges were revoked from any authorization ID. 


Programmer Response: Change the REVOKE statement to 
conform to the rules for REVOKE. When a REVOKE statement 
lists several privileges to be revoked and several different 
‘revokee' authorization IDs, each of the authorization IDs must 
possess at least one of the specified privileges. Furthermore, 
except when the authorization ID requesting the REVOKE holds 
SYSADM authority, an authorization ID can revoke only the priv- 
ileges that it has granted to the 'revokee'. That is to say, with 
the exception of SYSADM, an authorization ID can revoke only 
the privileges that it has granted to other authorization IDs. 


Note: No one, not even a user with SYSADM authority, can 
revoke privileges on an object from the object owner. 


If a user holding SYSADM authority receives this return code, 
the 'BY' clause may have been omitted from the REVOKE 
statement. 


-557 INCONSISTENT GRANT/REVOKE KEYWORD 
keyword. PERMITTED KEYWORDS ARE keyword- 


list 


Explanation: The GRANT or REVOKE statement contains a 
syntax or spelling error at or before the specified 'keyword'. 
As an aid to the programmer, 'keyword-list' provides a list of 
the keywords that would be permitted in this context. 


Alternatively: 


¢ The mixture of privileges specified on the GRANT or 
REVOKE statement is not permitted. The privileges must all 
be of one type, and consistent with the form of the GRANT 
or REVOKE statement. 


e REVOKE UPDATE (column-list) is not permitted; only 
REVOKE UPDATE is valid. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the syntax of the GRANT or 
REVOKE statement. 


INVALID CLAUSE OR COMBINATION OF CLAUSES 
ON A GRANT OR REVOKE 


-558 


Explanation: The location qualifier specified for a GRANT or 
REVOKE statement is invalid. 


System Action: The statement cannot be executed. 


Programmer Response: Refer to Chapter 5 of SQL Reference 
for valid keywords for the GRANT statement. 





-559 ALL AUTHORIZATION FUNCTIONS HAVE BEEN 


DISABLED 


Explanation: The authorization mechanism has been disabled 
in the DB2 subsystem. Consequently, GRANT and REVOKE 
statements are ignored. 


System Action: The statement cannot be executed. No privi- 
leges were granted or revoked. 


Programmer Response: Do not attempt to execute GRANT or 
REVOKE statements unless and until the authorization mech- 
anism is enabled in the DB2 subsystem. 


-571 THE STATEMENT WOULD RESULT IN A MULTIPLE 


SITE UPDATE 


Explanation: Modifications to data can be made at only a 
single site within any given commit scope. This SQL code indi- 
cates that a request to modify data has already occurred within 
the current commit scope and that this statement would cause 
data at a different site to be modified. 


This SQL code is also returned when an application program 
operating in an IMS or CICS environment attempts to modify 
data by referring to a remote object. Referring to sucha 
remote object would result in remote data being modified. 


System Action: The statement cannot be executed. 


Programmer Response: Ensure that all requests for modifica- 
tions to the data are confined to a single site within any given 
commit scope. 


For application programs operating in an IMS or CICS environ- 
ment, ensure that no UPDATE, INSERT, or DELETE statement 
refers to a remote object. 


-601 THE NAME OF THE OBJECT TO BE CREATED IS 


IDENTICAL TO THE EXISTING NAME name OF THE 
OBJECT TYPE obj-type 


Explanation: The CREATE statement sought to create an object 
‘name' of type 'obj-type' when there is already an object of 
that type with the same name defined in the DB2 subsystem. if 
‘obj-type' is constraint, the 'name' was specified in the 
FOREIGN KEY clause of either a CREATE or ALTER TABLE 
statement. 


System Action: The CREATE or ALTER statement cannot be 
executed. No new object was created, and the existing object 
was not altered or modified. 


Programmer Response: Either the existing object must be 
dropped or another name must be chosen for the new object. If 
‘obj-type' is data set, an IDCAMS DELETE of the data set must 
be done before the CREATE is retried. Refer to Chapter 5 of 
SQL Reference for information about the scope of object names 
in DB2. 


-602 TOO MANY COLUMNS SPECIFIED IN A CREATE 


INDEX 


Explanation: The number of columns specified in the CREATE 
INDEX statement exceeds 16, the maximum permitted by DB2. 


System Action: The statement cannot be executed. The speci- 
fied index was not created. 


Programmer Response: The index definition must be modified 
to conform to the system-imposed column limit of 16. 


-559 — -613 


-603 A UNIQUE INDEX CANNOT BE CREATED 
BECAUSE THE TABLE CONTAINS ROWS WHICH 
ARE DUPLICATES WITH RESPECT TO THE 
VALUES OF THE IDENTIFIED COLUMNS 


Explanation: The index defined in the CREATE INDEX state- 
ment could not be created as unique because the specified 
table already contains rows that are duplicates with respect to 
the values of the identified columns. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the data to ascertain 
whether or not the duplicate data is valid. Alternatively, con- 
sider creating a non-UNIQUE index. 


-604 A COLUMN DEFINITION SPECIFIES AN INVALID 
LENGTH, PRECISION, OR SCALE ATTRIBUTE 


Explanation: A column definition in the CREATE or ALTER 
TABLE statement contains an invalid length, precision, or scale 
attribute specification. Alternatively, the specification of data 
type may be incorrect or invalid. 


System Action: The statement cannot be executed. The speci- 
fied table was not created or altered. 


Programmer Response: Correct the syntax, and resubmit the 
statement. Refer to Chapter 3 of SQL Reference for information 
about valid length, precision, and scale attributes for the 
columns in a DB2 table. 


-607 OPERATION operation IS NOT DEFINED FOR 
SYSTEM TABLES 


Explanation: The 'operation' specified in the SQL statement 
cannot be performed on system tables. You cannot insert into 
or delete from a DB2 catalog table. 


System Action: The statement cannot be executed. 


Programmer Response: Do not attempt to insert into or delete 
from a catalog table. 


-612 column-name IS A DUPLICATE COLUMN NAME 


Explanation: The CREATE INDEX or CREATE TABLE or 
CREATE VIEW statement specifies the same 'column-name' for 
two (or more) columns of the index, table, or view. Column 
names must be unique within an index, a table, or a view. 


System Action: The statement cannot be executed. The speci- 
fied index, table, or view was not created. 


Programmer Response: Correct the CREATE statement to 
specify unique names for each of the columns of the index, 
table, or view. 


-613 THE PRIMARY KEY IS TOO LONG OR HAS TOO 
MANY COLUMNS 


Explanation: This code is used to report that the sum of the 
length attributes of the columns identified in a PRIMARY KEY 
clause is greater than 254 bytes or the number of columns iden- 
tified is greater than 16. 


System Action: The CREATE or ALTER statement cannot be 
executed. The specified table cannot be created or altered. 


Programmer Response: The table definition must be modified 
to conform to the system-imposed limit of the sum of the length 
attributes of the columns identified in the PRIMARY KEY clause. 


SQL Return Codes 2-21 


-614 — -625 


~614 THE INDEX CANNOT BE CREATED BECAUSE THE 


SUM OF THE INTERNAL LENGTHS OF THE IDENTI- 
FIED COLUMNS IS GREATER THAN THE ALLOW- 
ABLE MAXIMUM 


Explanation: The index could not be created because the sum 
of the internal lengths of the key columns would exceed the 
allowable maximum. The maximum length permitted is a func- 
tion of whether the index is partitioned or not, whether the 
index is unique or not, and the number of subpages of the 
index. For a nonpartitioned index with less than 8 subpages 
(either unique or not), the maximum permitted key length is 254. 


System Action: The statement cannot be executed. The speci- 
fied index was not created. 


Programmer Response: The definition for the index must be 
modified (possibly by eliminating one or more key columns) to 
reduce the length of the key to the permitted maximum. Refer 
to Chapter 3 of SQL Reference if you require a complete expla- 
nation of other possible maximum key lengths and how they are 
computed. 


-616 obj-type1 obj-name1 CANNOT BE DROPPED 
BECAUSE IT IS REFERENCED BY obj-type2 
obj-name2 


Explanation: An object cannot be dropped if there are other 
objects dependent upon it. For example, a storage group 
cannot be dropped if there are one or more existing table 
spaces that use that storage group. 


Execution of the specified DROP statement would drop object 
‘obj-name1' of type 'obj-type1' on which object 'obj-name2' of 
type ‘obj-type2' is dependent. 


System Action: The statement cannot be executed. The speci- 
fied object was not dropped. 


Programmer Response: Verify that the object specified in the 
DROP statement was indeed the object to be dropped. If so, all 
the existing objects that have a dependency on that object must 
be dropped first. 


-618 OPERATION operation IS NOT ALLOWED ON 
SYSTEM DATA BASES 


Explanation: System databases cannot be the object of certain 
types of operations. The attempted ‘operation’ cannot be per- 
formed on system data bases. 


System Action: The statement cannot be executed. No 
changes were made to the specified system database. 


Programmer Response: Do not attempt to perform the 
requested operation on system databases. 


-619 OPERATION DISALLOWED BECAUSE THE 
WORKFILE DATA BASE IS NOT STOPPED 


Explanation: The statements CREATE, ALTER or DROP for a 
table space in the workfile database (DSNDBO7) cannot be proc- 
essed unless the workfile database is stopped (use the STOP 
statement). 


System Action: The statement cannot be executed. 


Programmer Response: Issue the -DISPLAY 
DATABASE(DSNDBO07) command to verify that the workfile data- 
base is stopped before resubmitting the statement. 
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-620 KEYWORD keyword IN stmt type STATEMENT IS 
NOT PERMITTED FOR A TABLESPACE IN THE 
WORKFILE DATA BASE 


Explanation: The specified keyword in the SQL statement is 
not allowed for a table space in the workfile database 
(DSNBO7). 


System Action: The statement cannot be executed. 


Programmer Response: Correct and resubmit the statement. 


~621 DUPLICATE DBID dhid WAS DETECTED AND PRE- 
VIOUSLY ASSIGNED TO database-name 


Explanation: The current database being created was 
assigned a DBID of 'dbid', which is identical to the DBID 
assigned to database 'database-name'. An inconsistency 
exists between the DB2 catalog and directory. 


System Action: The statement cannot be executed. No new 
object was created, and the existing object was not altered or 
modified. 


Programmer Response: Notify the system programmer. The 
inconsistency must be corrected before CREATE DATABASE 
will be successful. 


System Programmer Response: Refer to Section 4 of Diag- 
nosis Guide and Reference for information about DBD incon- 
sistencies. 


-623 A CLUSTERING INDEX ALREADY EXISTS ON 
TABLE table-name 


Explanation: The CREATE INDEX statement wouid create a 
second cluster index on the specified table. A given table can 
have only one cluster index. 


System Action: The statement cannot be executed. 


Programmer Response: Check to determine the identity and 
validity of the existing cluster index on the object table. Alter- 
natively, consider creating the index without the CLUSTER attri- 
bute. 


-624 TABLE table-name ALREADY HAS A PRIMARY 
KEY 


Explanation: The code is used to report that a primary key 
cannot be defined in an ALTER TABLE statement because the 
indicated table already has a primary key. 


System Action: The statement cannot be run. 


Programmer Response: A table cannot have more than one 
primary key. 


-625 TABLE table-name DOES NOT HAVE AN INDEX TO 
ENFORCE THE UNIQUENESS OF THE PRIMARY 
KEY 


Explanation: The code is used to report that an ALTER TABLE 
statement is invalid because the table does not have a unique 
index with a key that is identical to the nominated PRIMARY 
KEY. 


System Action: The statement cannot be executed. 


Programmer Response: Make sure the key list specified on the 
ALTER TABLE statement identifies an existing unique index of 
the table. 


-626 THE ALTER STATEMENT IS NOT EXECUTABLE 
BECAUSE THE PAGESET IS NOT STOPPED 


Explanation: An ALTER statement specifies a USING, PRIQTY, 
SECQTY, or ERASE clause, but the pageset is not stopped. 


System Action: The SQL statement cannot be executed. 


Programmer Response: Stop the pageset before resubmitting 
the statement. 


-627 THE ALTER STATEMENT IS INVALID BECAUSE 
THE PAGESET HAS USER-MANAGED DATA SETS 


Explanation: This code is used if a PRIQTY, SECQTY, or 
ERASE clause is specified, USING STOGROUP is not specified, 
and the pageset has user-managed data sets. 


System Action: The SQL statement cannot be executed. 


Programmer Response: Verify that the correct table or parti- 
tion is specified. The primary and secondary space allocation of 
a user-managed data set cannot be altered by means of an 
ALTER statement. 


-628 A SEGMENTED TABLESPACE MAY NOT BE PAR- 


TITIONED 


Explanation: The CREATE TABLESPACE statement contains 
both the SEGSIZE and NUMPARTS specification, but they are 
mutually exclusive. 


System Action: The statement cannot not be executed. 


Programmer Response: If the table space has to be partitioned 
then eliminate the SEGSIZE specification. 


-629 SET NULL CANNOT BE SPECIFIED BECAUSE 
FOREIGN KEY name CANNOT CONTAIN NULL 
VALUES 


Explanation: The code is used to report that the SET NULL 
option of the indicated FOREIGN KEY clause is invalid because 
no column of the key allows null values. The name is the 
constraint-name specified in the FOREIGN KEY clause or, if a 
constraint-name was not specified, the first column-name speci- 
fied in the clause. 


System Action: The statement cannot be run. 


Programmer Response: Change a column of the key to allow 
null values or change the delete rule. 


-631 FOREIGN KEY name IS TOO LONG OR HAS TOO 


MANY COLUMNS 


Explanation: This code is used to report that the sum of the 
length attributes of the columns identified in the indicated 
FOREIGN KEY clause is greater than 254 bytes or the number of 
columns identified is greater than 16. The name is the 
constraint-name specified in the FOREIGN KEY clause or, if a 
constraint-name was not specified, the first column-name speci- 
fied in the clause. 


System Action: The statement cannot be executed. 


Programmer Response: The table definition must be modified 
to conform to the system-imposed limit of the sum of the length 
attributes of the columns identified in the PRIMARY KEY clause. 


-626 — -635 


-632 THE TABLE CANNOT BE DEFINED ASA 
DEPENDENT OF table-name BECAUSE OF 
DELETE RULE RESTRICTIONS 


Explanation: This code is used to report that the object of an 
ALTER TABLE statement cannot be defined as a dependent of 
the indicated table because either: 


°* The relationship would form a cycle that would cause the 
table to be delete-connected to itself. 


e The relationship would cause the table to be delete- 
connected to the indicated table through multiple paths and 
the delete rule of the existing relationship is SET NULL. 


The error is due to the delete rules of existing relationships, not 
the delete rule specified in the FOREIGN KEY clause of the 
ALTER TABLE statement. 


System Action: The statement cannot be executed. 


Programmer Response: Eliminate the particular FOREIGN 
KEY clause from the ALTER or CREATE TABLE statement. 


-633 THE DELETE RULE MUST BE delete-rule 


Explanation: The code is used to report that the delete rule 
specified in a FOREIGN KEY clause of the ALTER TABLE state- 
ment is invalid. The indicated delete rule is required because: 


¢ Aself-referencing constraint must have a delete rule of 
CASCADE. 


¢ The relationship would cause the table to be delete- 
connected to the same table through multiple paths and 
such relationships must have the same delete rule. 


System Action: The statement cannot be executed. 


Programmer Response: Change the delete rule in the 
FOREIGN KEY clause. 


-634 THE DELETE RULE MUST NOT BE CASCADE 


Explanation: The code is used to report that the CASCADE 
delete rule specified in the FOREIGN KEY clause of an ALTER 
TABLE statement is invalid because: 


¢ The relationship would form a cycle that would cause a 
table to be delete-connected to itself. 


e The relationship would cause another table to be delete- 
connected to the same table through multiple paths with dif- 
ferent delete rules or with a delete rule equal to SET NULL. 


System Action: The statement cannot be executed. 


Programmer Response: Change the delete rule. 


-635 THE DELETE RULES CANNOT BE DIFFERENT OR 
CANNOT BE SET NULL 


Explanation: The code is used to report that the delete rules 
specified in two FOREIGN KEY clauses of the CREATE TABLE 
statement are invalid because the table would be delete- 
connected to the same table through multiple paths involving 
relationships with different delete rules or with delete rules of 
SET NULL. 


System Action: The statement cannot be executed. 


Programmer Response: Change the delete ruie. 


SQL Return Codes 2-23 





-636 — -653 


~636 THE PARTITIONING KEYS ARE NOT SPECIFIED IN 


ASCENDING OR DESCENDING ORDER 


Explanation: In the CREATE INDEX statement for the CLUSTER 
index for a partitioned table (that is, a table residing in a parti- 
tioned table space), the partitioning key values specified in the 
limit-key-value specifications were not in either ascending or 
descending order. 


System Action: The statement cannot be executed. The speci- 
fied cluster index was not created. 


Programmer Response: Correct the limit-key-value specifica- 
tions in the CREATE INDEX statement so that the limit-key- 
values for successive partitions are in strictly ascending or 
descending order. 


-637 DUPLICATE keyword KEYWORD 


Explanation: The SQL statement contains a duplicate specifi- 
cation for the 'keyword' keyword. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the statement to eliminate all! 
but one specification for the keyword. 


-638 TABLE table-name CANNOT BE CREATED 
BECAUSE COLUMN DEFINITION IS MISSING 


Explanation: The CREATE TABLE statement does not contain 
any column definition. 


System Action: The SQL statement cannot be executed. 


Programmer Response: Add column definition to the state- 


ment. 


-639 A NULLABLE COLUMN OF A FOREIGN KEY WITH 


A DELETE RULE OF SET NULL CANNOT BE A 
COLUMN OF THE KEY OF A PARTITIONED INDEX 


Explanation: A partition key of the clustering index cannot be 
updated. Therefore, a foreign key column with a delete rule of 
SET NULL cannot be a column of a partition key if that column is 
nullable. If this error occurs for an ALTER TABLE operation, 
the foreign key cannot be created. If this error occurs for a 
CREATE INDEX operation, the index cannot be created. 


System Action: The statement cannot be executed. 


Programmer Response: Review the delete rule of the referen- 
tial constraint and the partition keys for the index. Do one of the 
following: 


¢ Ifthe operation in error was CREATE INDEX, either change 
the index partition key definition or drop and redefine the 
referential constraint with a different delete rule. 


¢ Ifthe operation in error was ALTER TABLE, change the ref- 
erential deijete rule so that all nullable index keys are not 
part of the foreign keys. 


-644 INVALID VALUE SPECIFIED FOR KEYWORD 
keyword IN stmt-type STATEMENT 


Explanation: The value specified for the 'keyword' parameter 
in the 'stmt-type' SQL statement is not a permitted value. 


System Action: The SQL statement cannot be executed. 


Programmer Response: Correct the statement. Refer to 
Chapter 5 of SQL Reference for information about the permis- 
sible values for the 'keyword' keyword in 'stmt-type' state- 
ments. 


2-24 DB2 Messages and Codes 


-646 TABLE table-name CANNOT BE CREATED IN 
PARTITIONED/DEFAULT TABLESPACE tspace- 
name BECAUSE IT ALREADY CONTAINS A TABLE 


Explanation: The table space specified ina CREATE TABLE 
statement is a partitioned or default table space in which an 
existing table already resides. Only one table may reside in a 
partitioned or default table space. 


System Action: The statement cannot be executed. The speci- 
fied table was not created. 


Programmer Response: Verify that the correct table space was 
specified in the CREATE statement. Do not attempt to create 
more than one table in a partitioned or default table space. 


-647 BUFFERPOOL bp-name CANNOT BE SPECIFIED 
BECAUSE IT HAS NOT BEEN ACTIVATED 


Explanation: The buffer pool specified in a CREATE or ALTER 
statement for a table space or index (index space) is not acti- 
vated (that is, the buffer pool was not activated during the start 
up of DB2). 


Table spaces and indexes (index spaces) can only be assigned 
(or reassigned) to buffer pools that are currently activated. 


System Action: The statement cannot be executed. The speci- 
fied table space or index(space) was not created or altered. 


Programmer Response: Verify that the proper buffer pool was 
specified in the CREATE or ALTER statement. If so, ensure that 
the buffer pool is activated before resubmitting the statement 
for execution. 


-652 VIOLATION OF INSTALLATION DEFINED EDIT OR 
VALIDATION PROCEDURE proc-name 


Explanation: The result of the SQL statement has been 
rejected by the installation defined edit or validation procedure 
'proc-name' for the object table. 


System Action: The statement cannot be executed. The con- 
tents of the object table were not modified. 


Programmer Response: Determine the requirements imposed 
by the edit or validation procedure for inserts and updates of 
the object table. 


~653 TABLE table-name IN PARTITIONED TABLESPACE 
tspace-name IS NOT AVAILABLE BECAUSE ITS 
PARTITIONED INDEX HAS NOT BEEN CREATED 


Explanation: An attempt has been made to insert or manipu- 
late data in or create a view on a partitioned table (that is, a 
table residing in a partitioned table space) before the parti- 
tioned index for that table has been created. 


A table residing in a partitioned table space cannot be refer- 
enced in any SQL manipulative statement or a CREATE VIEW 
statement before the partitioned index for that table has been 
created. 


System Action: The statement cannot be executed. 


Programmer Response: Verify that the correct table was spec- 
ified in the statement. If so, ensure that the partitioned index 
for the table has been created successfully before attempting to 
execute any SQL manipulative statements that reference that 
table. 


-660 INDEX index-name CANNOT BE CREATED ON 
PARTITIONED TABLESPACE tspace-name 


BECAUSE KEY LIMITS ARE NOT SPECIFIED 


Explanation: The CREATE INDEX statement attempted to 
create a cluster index for a partitioned table (that is, a table 
residing in a partitioned table space) without specifying limit- 
key-values for the partitions of the table space. 


System Action: The statement cannot be executed. The speci- 
fied cluster index was not created. 


Programmer Response: Verify that the correct table was spec- 
ified in the CREATE !NDEX statement. If so, the definition for the 
partitioned table space must be examined so that a proper defi- 
nition for the cluster index for the table may be constructed. 
Refer to Chapter 5 of SQL Reference for information about the 
requirements that must be satisfied by the definitions for the 
cluster indexes for partitioned tables. 


-661 INDEX index-name CANNOT BE CREATED ON 
PARTITIONED TABLESPACE tspace-name 
BECAUSE THE NUMBER OF PART SPECIFICA- 
TIONS IS NOT EQUAL TO THE NUMBER OF PARTI- 


TIONS OF THE TABLESPACE 


Explanation: The CREATE INDEX statement for the cluster 
index on a partitioned table (that is, a table residing in a parti- 
tioned table space) does not contain the same number of PART 
specifications as there are partitions in the table space. The 
definition for the cluster index for a partitioned table must 
contain exactly as many PART specifications as there are parti- 
tions in the table space in which that table resides. Also, the 
part numbers must be valid and unique. 


System Action: The statement cannot be executed. The speci- 
fied cluster index was not created. 


Programmer Response: Examine the definition of the parti- 
tioned table space to determine how many partitions have been 
specified, and then correct the syntax of the CREATE INDEX 
statement to provide the proper number of PART specifications. 
Refer to Chapter 5 of SQL Reference for information about the 
definitions for cluster indexes on partitioned tables. 


-662 A PARTITIONED INDEX CANNOT BE CREATED ON 


A NON-PARTITIONED TABLESPACE tspace-name 


Explanation: The CREATE INDEX statement contains PART 
specifications, but the specified object table is not partitioned 
(that is, does not reside in a partitioned table space). 


System Action: The statement cannot be executed. The speci- 
fied index was not created. 


Programmer Response: Verify that the proper object table was 
specified in the statement. Refer to Chapter 5 of SQL Reference 
for information about the proper usage of PART specifications 
in CREATE INDEX statements. 


-663 THE NUMBER OF KEY LIMIT VALUES IS EITHER 
ZERO, OR GREATER THAN THE NUMBER OF 


COLUMNS IN THE KEY OF INDEX index-name 


Explanation: The number of limit key value specifications pro- 
vided in at least one of the PART specifications of the CREATE 
INDEX statement is either zero or greater than the number of 
columns in the index key. 


System Action: The statement cannot be executed. The speci- 
fied index was not created. 


-660 — -666 


Programmer Response: Correct the statement so that each 
PART specification contains exactly the same number of limit 
key value specifications as there are columns in the index key. 


-664 THE INTERNAL LENGTH OF THE LIMIT-KEY 
FIELDS FOR THE PARTITIONED INDEX index- 
name EXCEEDS THE LENGTH IMPOSED BY THE 


INDEX MANAGER 


Explanation: The CREATE INDEX statement defines a parti- 
tioned index (that is, the cluster index for a table residing ina 
partitioned table space), and the length of the index key would 
exceed the permitted maximum. 


The index manager restricts the internal length of the keys for a 
partitioned index to a maximum of 40 bytes. The sum of the 
internal! tengths of the key columns specified for the index 
defined in the CREATE INDEX statement exceeds that 40-byte 
maximum, 


System Action: The statement cannot be executed. The speci- 
fied index was not created. 


Programmer Response: The definition for the index must be 
modified (probably by eliminating one or more columns from 
the key) so that the internal length of the key will not exceed the 
system-imposed 40-byte limit. Refer to Chapter 5 of SQL Refer- 
ence for information about the special restrictions that must be 
satisfied by the definitions for partitioned indexes. 


-665 THE PART CLAUSE OF AN ALTER STATEMENT IS 


OMITTED OR INVALID 


Explanation: The ALTER statement is invalid for one of the fol- 
lowing reasons: 


°® The table space or index is not partitioned and the PART 
clause is specified. 


¢ The table space or index is partitioned, a partition attribute 
(FREEPAGE or PCTFREE) is specified, and the PART clause 
is not specified. 


° The integer specified in the PART clause does not identify a 
partition of the table space or index. 


e¢ A USING, PRIQTY, SECQTY, or ERASE clause is used to 
alter storage attributes, but the partition is not specified. 


System Action: The statement cannot be executed. The speci- 
fied index or table space was not altered. 


Programmer Response: Determine whether the table space or 
index you want to alter is partitioned. If it is partitioned, specify 
a PART clause that identifies the partition you want to alter. If it 
is not partitioned, do not specify the PART clause. 


-666 stmt-verb object CANNOT BE EXECUTED 


BECAUSE function IS IN PROGRESS 


Explanation: The SQL statement could not be executed 
because the named function was executing at the time. Inthe 
message, 'stmt-verb' is the type of data definition language 
(DDL) statement, 'object' is the DB2 object type, and ‘function’ 
is a utility, the governor, or the distributed data facility (DDF). 


If the object is part of the communications database, it cannot 
be dropped while the DDF is active. 


System Action: The statement was not executed. 


Programmer Response: If the function is a utility, wait for the 
function to complete or stop and then resubmit the statement 
for execution. If the function is the governor, the statement 
cannot be executed until the resource limit facility is stopped or 
switched to a different resource limit contro| table. If the func- 
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-667 — -677 


tion is the DDF, the facility must be stopped before the object 
can be dropped. 


-667 THE CLUSTERING INDEX FOR A PARTITIONED 


TABLESPACE CANNOT BE EXPLICITLY DROPPED 


Explanation: The DROP INDEX statement attempted to drop the 
cluster index for a table residing in a partitioned table space. 
The cluster index for such a table cannot be dropped explicitly 
with the DROP INDEX statement. 


System Action: The statement cannot be executed. The speci- 
fied index was not dropped. 


Programmer Response: The cluster index for a table in a parti- 
tioned table space can only be dropped implicitly when the 
associated partitioned table space is dropped. 


-668 THE COLUMN CANNOT BE ADDED TO THE TABLE 


BECAUSE THE TABLE HAS AN EDIT PROCEDURE 


Explanation: The ALTER TABLE statement attempted to adda 
column to a table that has an edit procedure. If a table has an 
edit procedure, no columns can be added to it. 


System Action: The statement cannot be executed. The speci- 
fied table was not altered. 


Programmer Response: Verify that the correct table was spec- 
ified in the ALTER statement. Do not attempt to ALTER the defi- 
nition of a table that has an installation-written edit procedure 
associated with it. 


-669 A TABLE IN A PARTITIONED TABLESPACE 
CANNOT BE EXPLICITLY DROPPED 


Explanation: The DROP TABLE statement attempted to drop a 
table that resides in a partitioned table space. 


System Action: The statement cannot be executed. The speci- 
fied table was not dropped. 


Programmer Response: The table of a partitioned table space 
can only be dropped implicitly when the table space itself is 
dropped. 


~670 THE RECORD LENGTH OF THE TABLE EXCEEDS 


THE PAGE SIZE LIMIT 


Explanation: The row length for a table cannot exceed the 
page size of the table space in which that table resides (or is to 
reside). The page size of the table space is determined by the 
buffer pool used by that table space. 


One of three conditions may occur: 


¢ As defined in a CREATE TABLE statement, the row length 
for the table would exceed the page size of the specified (or 
default) table space. 


* Inthe case of an ALTER TABLE statement, addition of the 
specified column would cause the row length of the table to 
exceed the page size of the table space. 


¢ The row length in the resuit of a join exceeds the page size 
of a workfile table space. 


System Action: The statement cannot be executed. The object 
table was not created or altered. 


Programmer Response: In the case of CREATE TABLE, either 
(1) the row length of the table must be reduced (by eliminating 
or reducing the lengths of one or more of the columns), or 

(2) the table must be assigned to a table space that uses the 
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32K-byte buffer pool (assuming that the row length of the table 
does not exceed that page size limit). 


In the case of ALTER TABLE, either (1) the length of the column 
to be added to the table must be reduced or, (2) if the row 
length of the table is already at the maximum, the table cannot 
be altered to add any additional columns. 


In the case of a row length that exceeds the page size of a 
workfile table space, eliminate columns from the result of the 
join. 


-671 THE BUFFERPOOL ATTRIBUTE OF THE 
TABLESPACE CANNOT BE ALTERED AS SPECI- 
FIED BECAUSE IT WOULD CHANGE THE PAGE 
SIZE OF THE TABLESPACE 


Explanation: The change to the buffer pool attribute for the 
table space specified in the ALTER TABLESPACE statement 
would change the page size of the table space—either from 4K 
to 32K bytes, or vice versa. 


Use of the ALTER TABLESPACE statement to change the page 
size of a table space is not permitted. 


System Action: The statement cannot be executed. The table 
space definition was not altered. 


Programmer Response: if the table space uses one of the 
4K-byte buffer pools (for example, BPO, BP1, or BP2), it can be 
reassigned to one of the other 4K-byte buffer pools (but not 
buffer pool BP32K). If, however, it is assigned to buffer pool 
BP32K, the buffer pool assignment cannot be subsequently 
altered. 


-676 A 32K PAGE BUFFERPOOL MAY NOT BE USED 
FOR AN INDEX 


Explanation: A buffer pool having a 32K-byte page size was 
specified in the CREATE INDEX statement. Only 4K-byte buffer 
pools (that is, BPO, BP1, and BP2) can be specified for indexes. 


System Action: The statement cannot be executed. The speci- 
fied index was not created. 


Programmer Response: Correct the statement to specify a 
4K-byte buffer pool. Refer to Chapter 6 of SQL Reference for 
information about the syntax of SQL statements. 


-677 INSUFFICIENT VIRTUAL STORAGE FOR 
BUFFERPOOL EXPANSION 


Explanation: An attempt to either open (create) or expand a 
buffer pool has failed because insufficient virtual storage was 
available. 


This error may occur under either of two circumstances: 


e An attempt to create a buffer pool while opening a table 
space or index(space), or 

* An attempt to expand a buffer pool from its current size to 
its maximum size. 


System Action: The statement cannot be executed. 


Programmer Response: If this error should occur during inter- 
active execution of an SQL statement or execution of an appli- 
cation program, installation administration should be notified. 


Installation Action: It may be necessary to reexamine the buffer 
pool storage strategy. 


One of the following messages has also been sent to the MVS 
console: DSNB601!, DSNB603I, or DSNB605I. Refer to “Section 
3. DB2 Messages” on page 3-1 for explanations of these mes- 
sages. 


-678 THE LITERAL literal SPECIFIED FOR THE INDEX 


LIMIT KEY MUST CONFORM TO THE DATA TYPE 
data-type OF THE CORRESPONDING COLUMN 
column-name 


Explanation: The index limit key value 'literal' has been spec- 
ified incorrectly in the CREATE INDEX statement. 


Limit key value specifications must conform to the data type of 
the corresponding index key column. !n this case, the ‘literal’ 
must be of data type 'data-type' to conform to the data type of 
column 'column-name'. 


System Action: The statement cannot be executed. The speci- 
fied index was not created. 


Programmer Response: Correct the statement so that each 
limit key value literal is of precisely the same data type as that 
of the corresponding index key column. 


-679 THE OBJECT name CANNOT BE CREATED 
BECAUSE A DROP IS PENDING ON THE OBJECT 


Explanation: The application program has executed a DROP 
for the specified object, and then tried to re-create an object 

with the same name (and of the same type) before the DROP 
was completed. 


System Action: The statement cannot be executed. The speci- 
fied object was not created. 


Programmer Response: The logic of the application program 
must be modified to issue a COMMIT (or the IMS/VS or CICS 
equivalent) between the DROP and CREATE statements. 


-680 TOO MANY COLUMNS SPECIFIED FOR A TABLE 


Explanation: The maximum number of columns permitted per 
table is 300. 


System Action: The statement cannot be executed. 


Programmer Response: Do not attempt to CREATE or ALTER a 
table to contain more than 300 columns. Create separate tables 
as required to hold the additional information. 


-681 COLUMN column-name IN VIOLATION OF INSTAL- 


LATION DEFINED FIELD PROCEDURE. AT: return- 
code, RS: reason-code, MSG: message-token 


Explanation: An installation field procedure returned an error 
for 'column-name'. The 'reason-code' and 'message-token' 
are defined by the field procedure. They may give additional 
information to help determine the cause of the problem. 


Return code Error 

4 Invalid value on encode or decode or invalid 
column description on define 

8 Invalid parameter value 

12 Field procedure error on any function 


Use 'reason-code' and 'message-token' for additional infor- 
mation. 


System Action: The statement cannot be executed. 


Programmer Response: If it is not a field procedure error, 
determine the requirements imposed by the field procedure. If 
it is a field procedure error, examine the field procedure. 


-678 — -687 


-682 FIELD PROCEDURE procedure-name COULD NOT 
BE LOADED 


Explanation: The field procedure 'procedure-name' cannot be 
loaded. 


System Action: The statement cannot be executed. 


Programmer Response: The application shoutd either commit 
or roll back to previous COMMIT. Then, in general, the applica- 
tion should terminate. 


-683 INVALID COLUMN TYPE FOR FIELDPROC OR BIT 
DATA OPTION, column-name 


Explanation: The FIELDPROC or BIT DATA option was speci- 
fied for column 'column-name'. This is invalid. FIELDPROC or 
BIT DATA cannot be specified for a numeric column, date 
column, time column, long string column, or non-null default 
value column. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the SQL statement. 


-684 THE LENGTH OF LITERAL LIST BEGINNING string 
IS TOO LONG 


Explanation: The length of the literal list beginning with 
‘string', excluding insignificant blanks and delimiting paren- 
theses is greater than 254. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the SQL statement. 





-685 INVALID FIELD TYPE, column-name 


Explanation: The field description returned by the field proce- 
dure is invalid. The data type code denotes a long string or has 
an invalid value. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the field procedure so that it 
returns a valid data type code. 


-686 COLUMN DEFINED WITH A FIELD PROCEDURE 
CAN NOT COMPARE WITH ANOTHER COLUMN 
WITH DIFFERENT FIELD PROCEDURE 


Explanation: The columns specified are not compatible. Dif- 
ferent field procedures are specified, or only one field proce- 
dure is specified. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the SQL statement. Refer to 
Chapter 5 of SQL Reference for comparison restrictions 
between columns defined with a field procedure. 


-687 FIELD TYPES INCOMPARABLE 


Explanation: One column cannot be compared with another 
column that has incompatible field types. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the SQL statement. Refer to 
Chapter 5 of SOL Reference for comparison restrictions 
between columns defined with a field procedure. 
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-688 INCORRECT DATA RETURNED FROM FIELD PRO- 


CEDURE, column-name, msgno 


Explanation: Unexpected data returned from field procedure 
for column 'column-name'. For more information see 
'msgno'. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the field procedure so that it 
returns values that are consistent with their descriptions. 


~802 EXCEPTION ERROR 'exception-type' HAS 
OCCURRED DURING 'operation-type' OPERA- 
TION ON '‘data-type' DATA, POSITION | 
‘position-number' 


Explanation: The processing of an SQL arithmetic function or 
arithmetic expression that was either in the SELECT list of an 
SQL select statement, in the search condition of a SELECT, 
UPDATE, or DELETE statement, during the evaluation of a 
column function, or in the SET clause of the UPDATE statement 
has encountered an exception error, possibly indicated by 
‘exception-type'. Possible values for 'exception-type' are 
FIXED POINT OVERFLOW, DECIMAL OVERFLOW, DIVIDE 
EXCEPTION, or EXPONENT OVERFLOW. ‘data-type' may indi- 
cate the data types of the items being manipulated, and 
‘operation-type' may indicate the arithmetic operation that was 
being performed at the time of the error. !f the error was in the 
SELECT list of an outer SELECT statement then 
'position-number' may indicate the position of the expression 
in the select list. The possible data-types are INTEGER, 
SMALLINT, DECIMAL, and FLOAT. The data type displayed in 
the message may indicate the data type of the temporary 
internal copy of the data which may differ from the actual 
column or literal data type due to conversions by DB2. The 
possible operation-types are ADDITION, SUBTRACTION, MULTI- 
PLICATION, DIVISION, and NEGATION. 


A fixed point overflow can occur during any arithmetic opera- 
tion on either INTEGER or SMALLINT fields. 


A decimal overflow exception can occur when one or more non- 
zero digits are lost because the destination field in any decimal 
operation is too short to contain the result. 


A divide exception can occur on a division operation on any 
numeric field type (DECIMAL, FLOAT, SMALLINT, or INTEGER) 
by zero, or on a decimal division operation when the quotient 
exceeds the specified data-field size. 


An exponent overflow can occur when the result characteristic 
of any floating point operation exceeds 127 and the result frac- 
tion is not zero, for example, the magnitude of the result 
exceeds approximately 7.2E+75. 


Note: Parts of 'exception-type' ‘data-type' 'operation-type' 
'position-number' may or may not be returned in SQLCA, 
depending on where the error was detected. 


System Action: The statement cannot be executed. In the case 
of an INSERT or UPDATE statement, no data is updated or 
deleted. If the statement was a cursor controlled FETCH then 
the CURSOR will remain open, else if it was a cursor controlled 
OPEN then the CURSOR will remain closed. 


Programmer Response: Examine the SQL statement to see if 
the cause (or the likely cause) of the problem can be deter- 
mined. The problem may be data-dependent, in which case it 
will be necessary to examine the data that was being proc- 
essed at the time the error occurred. 


If the arithmetic expression in error was within the SELECT list 
of the outer SELECT statement then it is advisable to include an 
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indicator variable for all expressions in the SELECT list. This 
will enable processing to continue such that non-error column 
and expression values may be returned. 


See the explanation of SQLCODE -405 for allowed ranges of 
numeric data types. 


-803 AN INSERTED OR UPDATED VALUE JS INVALID 
BECAUSE THE INDEX index-name CONSTRAINS 
COLUMNS OF THE TABLE SUCH THAT NO TWO 
ROWS CAN CONTAIN DUPLICATE VALUES IN 
THOSE COLUMNS. RID OF EXISTING ROW IS 
X'rid' 


Explanation: The table that is the object of the INSERT or 
UPDATE operation is constrained (by UNIQUE INDEX 
'index-name') to have unique values in certain columns. Com- 
pletion of the requested INSERT or UPDATE would result in 
duplicate values occurring in row 'rid'. 


If a view is the object of the INSERT or UPDATE statement, the 
table that defines the view is constrained. The update might 
also be caused by a DELETE operation of a parent row that cas- 
cades to a dependent row with a delete rule of SET NULL. 


System Action: The INSERT, UPDATE, or DELETE statement 
cannot be executed. The object table is unchanged. 


Programmer Response: Examine the definitions for UNIQUE 
INDEX 'index-name' to determine the uniqueness constraint 
imposed. 


For an UPDATE statement, verify that the specified operation is 
consistent with the uniqueness constraint. If this does not indi- 
cate the error, examine the object table to determine the cause 
of the problem. 


For an INSERT statement, examine the object table to deter- 
mine which values violate the uniqueness constraint. If the 
INSERT statement contains a subquery, match the contents of 
the table addressed by the subquery and the contents of the 
object table to determine the cause of the problem. 


For a DELETE statement, examine the index key columns in the 
table that defines the index. These columns contain a foreign 
key, which when set NULL on a cascade delete from the object 
table, causes the duplicate values. 


~804 AN ERROR WAS FOUND IN THE APPLICATION 
PROGRAM INPUT PARAMETERS FOR THE SQL 
STATEMENT : 


Explanation: The call parameter list or the SQLDA is in error, 
or the length control field of a varying length string variable is 
negative. 


The call parameter list, which is created by the precompiler, 
may be invalid if the application programmer has modified the 
output of the precompiler, used a variable name beginning with 
‘SQL' in the application program, or overwritten the call 
parameter list in some other way. 


One of the following conditions exists: 


¢ The SQLDA, which is created by the application program, 
has an invalid length or may contain an invalid data type or 
data length. 


¢ The value of SQLDABC is not consistent with the value of 
SQLD. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the application program for 
any of the errors noted under Exptanation above. Note that, in 
general, the application programmer should not attempt to 
modify the output of the precompiler. 


-805 PROGRAM NAME program-name NOT FOUND IN 


PLAN plan-name_ 


Explanation: An attempt was made to execute the application 
program 'program-name' with a DBRM that has not been 
bound as part of the application plan 'plan-name.' 


System Action: The statement cannot be executed. 


Programmer Response: Rebind the application. Be sure that 
the DBRMs for all SQL bearing application programs executed 
in the application are specified in the BIND command. 


THE RESULT OF AN EMBEDDED SELECT STATE- 
MENT IS A TABLE OF MORE THAN ONE ROW, OR 
THE RESULT OF THE SUBQUERY OF A BASIC 
PREDICATE IS MORE THAN ONE VALUE 


-811 


Explanation: Execution of an embedded SELECT statement has 
resulted in a result table containing more than one row. Alter- 
natively, a subquery contained in a basic predicate has 
produced more than one value. 


System Action: The statement cannot be executed. 


Programmer Response: Examine the syntax of the statement 
to ensure that it contains the proper condition specifications. If 
it does, there may be a problem with the data that is causing 
more than one row or value to be returned when you do not 
expect it. 


-815 A GROUP BY OR HAVING CLAUSE IS IMPLICITLY 
OR EXPLICITLY SPECIFIED IN AN EMBEDDED 
SELECT STATEMENT OR A SUBQUERY OF A 


BASIC PREDICATE 


Explanation: An embedded SELECT statement or a subquery 
of a basic predicate either (1) directly contains a GROUP BY or 
HAVING clause, or (2) specifies as its object a view having a 
definition that includes a GROUP BY or HAVING clause. Neither 
construct is permitted. 


System Action: The statement cannot be executed. No data 
was retrieved. 


Programmer Response: The implied function is not supported 
by DB2. In the case of a view, embedded SELECT statements 
cannot be used to retrieve data from that view. 


-817 THE INSERT, UPDATE, DELETE, DDL, OR 
AUTHORIZATION STATEMENT CANNOT BE EXE- 
CUTED BECAUSE THE IMS/VS TRANSACTION IS 


INQUIRY ONLY 


Explanation: An application that is running as an inquiry-only 
transaction has attempted to execute an INSERT, UPDATE, 
DELETE, data definition (CREATE, ALTER, or DROP), or authori- 
zation (GRANT or REVOKE) statement. Such statements result 
in updates to the user data or the subsystem catalog, and 
cannot be executed by an application running as an inquiry- 
only transaction. 


System Action: The statement cannot be executed. 


Programmer Response: See your IMS/VS system programmer 
about changing the inquiry-only status of the transaction under 
which your application is running. 


-805 — -820 


THE PRECOMPILER-GENERATED TIMESTAMP x 
IN THE LOAD MODULE IS DIFFERENT FROM THE 
BIND TIMESTAMP y BUILT FROM THE DBRM 


-818 


Explanation: The SQL precompiler places timestamp '‘y' in the 
DBRM, and time stamp 'x' in the parameter list in the applica- 
tion program for each SQL statement. At BIND time, DB2 stores 
the DBRM timestamp for run-time use. At run-time, timestamp 
'x', for the SQL statement being processed, is compared with 
timestamp 'y' derived from the DBRM at BIND time. If the two 
timestamps do not match, the DBRM and the application 
program were not the result of the same precompile. 


This problem can occur if you: 


¢ Precompile, compile, and link, without doing a BIND of the 
application, 

¢ Precompile and BIND, without doing the compile and link 
for the application program, or 

¢ BIND the application using a DBRM that resulted from a dif- 
ferent precompile of the application program than that 
which produced the object module that is linked into the 
application module. 


The timestamps 'x' and 'y' are DB2 internal timestamps. They 
do not have an external interpretation. 


System Action: The statement cannot be executed. 


Programmer Response: BIND the application again, using the 
DBRM for the application program that matches the object 
module. 


-819 THE VIEW CANNOT BE PROCESSED BECAUSE 
THE LENGTH OF ITS PARSE TREE IN THE 


CATALOG IS ZERO 


Explanation: SYSIBM.SYSVTREE.VTREE is a varying-length 
string column that contains the parse trees of views. In proc- 
essing a view, the length control field of its parse tree was 
found to be zero. 


System Action: The statement cannot be executed. 


Programmer Response: This is a system error. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


-820 THE SQL STATEMENT CANNOT BE PROCESSED 
BECAUSE catalog-table CONTAINS A VALUE 


THAT IS NOT VALID IN THIS RELEASE 


Explanation: A column of the indicated catalog table contains a 
value that prevents further processing of an SQL statement. 
The meaning of the value is unknown to the release of DB2. Ifa 
fall back has occurred, the value is probably the result of the 
use of new function prior to the fallback. 


System Action: The statement cannot be executed. 


Programmer Response: Verify that the statement refers to the 
intended tables or views and that the problem is the result of a 
fallback. If this is the case, the statement cannot be corrected 
because it depends on a function that is not supported in the 
current release. If the problem is not the result of a fallback, 
-820 is a system error. Refer to Section 5 of Diagnosis Guide 
and Reference for failure analysis procedures. 
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~822 THE SQLDA CONTAINS AN INVALID DATA 


ADDRESS OR INDICATOR VARIABLE ADDRESS 


Explanation: The application program has placed an invalid 
address in the SQLDA. 


System Action: The statement cannot be executed. 


Programmer Response: Correct the application program such 
that valid addresses are placed in SQLDA. 


-840 TOO MANY ITEMS RETURNED IN A SELECT OR 


INSERT LIST 


Explanation: The number of items returned in the select list or 
presented in an insert list exceeds the allowable maximum of 
300. 


System Action: The statement cannot be executed. 


Programmer Response: Determine whether all the information 
is actually needed. (Note that the number of items returned by 
the select list * in the SQL statement SELECT * from A, B, C is 
the sum of the number of columns in all three tables.) If not, 
rewrite the SQL statement so that only the necessary items of 
information are returned. If so, break the SQL statement up into 
two or more statements, as required. 


-901 UNSUCCESSFUL EXECUTION CAUSED BY A 
SYSTEM ERROR THAT DOES NOT PRECLUDE THE 
SUCCESSFUL EXECUTION OF SUBSEQUENT SQL 


STATEMENTS 


Explanation: A system error has occurred that prevented suc- 
cessful execution of the current SQL statement. However, the 
error was not of a kind that would preclude successful exe- 
cution of further SQL statements. 


System Action: The statement cannot be executed. An OFE 
abend is requested for the application. However, the applica- 
tion program may have a recovery routine and may retry SQL 
statements. 


Programmer Response: Notify the system programmer for 
analysis of the abend that caused this return code. 


An application program receiving this return code may retry 
and is not prohibited from executing further SQL statements. 


-904 UNSUCCESSFUL EXECUTION CAUSED BY AN 
UNAVAILABLE RESOURCE. REASON reason- 
code, TYPE OF RESOURCE resource-type, AND 


RESOURCE NAME resource-name 


Explanation: The SQL statement could not be executed 
because resource 'resource-name' of type 'resource-type' 
was not available at the time for the reason indicated by 
‘reason-code'. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of of resource 
type codes. Refer to “Section 4. DB2 Codes” on page 4-1 for an 
explanation of the given reason code. 


System Action: The SQL statement cannot be executed. 


Programmer Response: Verify the identity of the resource that 
was not available. The reason the resource was unavailable 
can be determined by checking the specified 'reason-code' in 
“Section 4. DB2 Codes” on page 4-1. 
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UNSUCCESSFUL EXECUTION DUE TO RESOURCE 
LIMIT BEING EXCEEDED, RESOURCE NAME = 
resource-name LIMIT = limit-amountt CPU 
SECONDS (limit-amount2 SERVICE UNITS) 
DERIVED FROM limit-source 


Explanation: The execution of the SQL statement was termi- 
nated because a resource limit was exceeded. 


The name of the resource whose limit was exceeded is 
'resource-name'. It is also the name of the column in the 
resource limit specification table from which the limit was 
derived. The limit that was exceeded in CPU seconds is 
‘limit-amount1' and in service units it is 'limit-amount2'. The 
‘resource-name' may be ASUTIME, which is the number of 
CPU seconds permitted for each SQL statement. The maximum 
number of CPU seconds permitted is 'limit-amount1'. The 
maximum number in service units is ‘limit-amount2'. 


The source used to derive the limit-amount is 'limit-source' 
and is either the name of a resource limit specification table or 
a 'system parameter'. If the source is a system parameter, the 
resource limit specification table did not contain an applicable 
entry or an error occurred while accessing the table. In either 
case, the limit is obtained from an install (system) parameter. 


System Action: The execution of this SQL statement is termi- 
nated. A record containing more detailed information about 
this failure is generated. If there is an SQL cursor associated 
with the failed instruction, its position is unchanged and a 
CLOSE or PREPARE command may be issued. If any other 
operation is attempted with the cursor, it cannot be executed 
and a '-905' error code is returned. If there is no cursor, this 
statement has been rolled back. 


Programmer Response: Determine why this SQL statement 
took so long and take appropriate action. Consider simplifying 
the SQL statement, restructuring tables and indexes, or con- 
tacting the instaliation group responsible for maintaining the 
resource limit specification tables. 


An application program that receives this return code can 
execute additional SQL statements. 


-906 THE SQL STATEMENT CANNOT BE EXECUTED 
BECAUSE THIS FUNCTION IS DISABLED DUE TO 


A PRIOR ERROR 


Explanation: Execution of the SQL statement failed because 
the requested function had been disabled because of a prior 
error. This situation can arise if the application program has 
intercepted an abend (for instance, by an ON ERROR condition 
in a PL/I program) and continued to execute SQL statements. 


System Action: The statement cannot be executed. 


Programmer Response: In general, an application program 

should terminate upon receipt of this return code. All subse- 
quent attempts by the application to execute other SQL state- 
ments will also fail with the same return code. 


-907 UNABLE TO DETERMINE IF THE ATTEMPT TO 
COMMIT UPDATES MADE AT A REMOTE SITE 


WAS SUCCESSFUL OR NOT. 


Explanation: A system error occurred at the remote site where 
the updates were made, or a communication failure with the 
remoie site occurred. The error occurred after the request to 
commit the updates was transmitted to the site. The error pre- 
vents DB2 from determining whether the commit operation suc- 
ceeded. 


System Action: Ifthe commit operation succeeded, the updates 
appear in the data stored at the remote site. If the operation 
did not succeed, the updates are backed out. 


The SQL COMMIT operation was not completed and an OFE 
abend was requested for the application. The application 
program, however, may have a recovery routine and may retry 
SQL statements. 


Programmer Response: After communication has been rees- 
tablished with the remote site, you can use SQL to query the 
data to determine whether the COMMIT operation was suc- 
cessful. 


An application that receives this return code is allowed to retry | 
or execute additional SQL statements. 


-909 THE OBJECT HAS BEEN DELETED 


Explanation: The application program has either (1) dropped a 
table and then attempted to access it, or (2) dropped an index 
and then tried to access its object table using that index. 


System Action: The statement cannot be executed. 


Programmer Response: The logic of the application program 
must be corrected such that it does not attempt to access or use 
an object after it has been dropped. | 


Dropping indexes within an application program is especially | 
hazardous, because there is no way of determining whether or | 
not the plan that has been generated for the application (by 

BIND or REBIND) actually uses a particular index for access to 

its object table. 


-910 THE SQL STATEMENT CANNOT ACCESS AN 
OBJECT ON WHICH A DROP OR ALTER IS | 


PENDING 


Explanation: The application program has issued a DROP or 
ALTER against an object, and then attempted to access that 
object before the DROP or ALTER is completed. 


System Action: The statement cannot be executed. 


Programmer Response: in the case of ALTER, the logic of the 
application program must be modified so that a COMMIT (or the 
iMS/VS or CICS equivalent) is executed between the ALTER and 
the failing SQL statement. 


For DROP, the logic of the application program should be modi- 
fied such that there is no attempt to access an object after the 
DROP has been executed. 


-911 THE CURRENT UNIT OF WORK HAS BEEN 
ROLLED BACK DUE TO DEADLOCK OR TIMEOUT. 
REASON reason-code, TYPE OF RESOURCE 
resource-type, AND RESOURCE NAME resource- 


name 


Explanation: The current unit of work was the victim in a dead- 
lock, or experienced a timeout, and had to be rolled back. | 


The reason code indicated whether a deadlock or timeout | 
occurred. Refer to message DSNT500I under “Service Con- 

troller and Installation Messages (DSNT...)” on page 3-121 for 

an explanation of resource type and resource name. Refer to 
Figure 4in Appendix B, “Problem Determination” on page X-5 

for an explanation of resource type codes. 


-909 — -922 


Note: The changes associated with the unit of work must be 
entered again. 


System Action: The statement cannot be executed. The appli- 
cation is rolled back to the previous COMMIT. 


Programmer Response: A long-running application, or an 
application that is likely to encounter a deadlock, should (if pos- 
sible) issue frequent COMMIT commands. This can lessen the 
possibility of a deadlock occurring. On receipt of the -911 

return code, the application should, in general, terminate. 


For more information about how iMS, CICS, and TSO handle 
deadlocks, see Section 4 of Application Programming and SQL 
Guide. 


-913 UNSUCCESSFUL EXECUTION CAUSED BY DEAD- 
LOCK OR TIMEOUT. REASON CODE reason-code, 
TYPE OF RESOURCE resource-type, AND 


RESOURCE NAME resource-name 


Explanation: The application was the victim in a deadlock or 
experienced a timeout. The reason code indicates whether a 
deadlock or timeout occurred. 


Refer to message DSNT500I under “Service Controller and 
Installation Messages (DSNT...)” on page 3-121 for an explana- 
tion of resource type and resource name. Refer to Figure 4 in 
Appendix B, “Problem Determination” on page X-5 for an 


-explanation of resource type codes. 


System Action: The statement cannot be executed. 


Programmer Response: The application should either commit 
or roll back to the previous COMMIT. Then, in general, the 
application should terminate. 


For more information about how IMS, CICS, and TSO handie 
deadlocks, see Section 4 of Application Programming and SQL 
Guide. 


-922 CONNECTION AUTHORIZATION FAILURE: error- 


type ERROR 


Explanation: Connection authorization failed because of the 
error indicated by 'error-type', which may be one of the fol- 
lowing: 


e User validation 

e Resource access 
¢ Subsystem name 
¢ {nstallation error. 


System Action: The statement cannot be executed. The con- 
nection to DB2 is not established. 


Programmer Response: [f 'error-type' is 'user validation’, the 
authorization-ID specified to DB2 through your attachment 
facility is not valid for DB2. See your system programmer or 
your CICS, IMS/VS, or TSO system administrator. 


If 'error-type' is 'plan access', allocation of a requested plan 
is not allowed. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for a list of other possible 
resources. See your system administrator. 


If 'error-type' is 'subsystem-name’, then you specified an 
invalid subsystem name. 


If 'error-type' is ‘installation-error', a logon validation exit has 
denied your request. See your system programmer. 
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-923 — -927 


-923 
REASON reason-code, TYPE resource-type, NAME 
resource-name 


Explanation: Connection to DB2 failed for the reason indicated 
by 'condition', which may be any of the following: 


* DB2 not up 

¢ DB2 not operational 

¢ DB2 shutdown in progress 
¢ DB2 restricted access mode 
e Allocation error. 


Possible causes of an allocation error are: 


¢ The application plan does not exist. 

* The application plan is inoperative. An explicit REBIND or 
BIND is required. 

¢ The application plan is invalid. Underlying resources have 
changed. 

¢ A required database, table space, table, or index is unavail- 
able. 

¢ Data set allocation has failed for a required data set. 

¢ There is insufficient virtual storage. 


System Action: The statement cannot be executed. The con- 
nection to DB2 is not established. 


Programmer Response: /f the connection failed because either 
DB2 or a required database, table space, table, or index was 
unavailable, wait until it is available before invoking the appli- 
cation again. 


If allocation failed for an application plan, REBIND the pian to 
determine the problem. Error messages will be produced 
explaining why the plan could not be allocated. 


For other types of allocation errors, installation action may be 
required to correct the problem. 


Problem Determination: The 'reason-code', ‘resource-type', 
and 'resource-name' may or may not be available. If they are 
not available, nothing will appear. If they are available, refer to 
“Section 4. DB2 Codes” for an explanation of the 
‘reason-code', ‘resource-type', and ‘resource-name'. 


Refer to message DSNT500!I under “Service Controller and 
Installation Messages (DSNT...)” for an explanation of resource 
type and resource name. Refer to Figure 4 in Appendix B, 
“Problem Determination” on page X-5 for an explanation of 
resource type codes. 


-924 DB2 CONNECTION INTERNAL ERROR, function- 


code, return-code, reason-code 


Explanation: Connection to DB2 has failed because of an unex- 
pected internal error, identified by the 'reason-code'. 


System Action: The statement cannot be executed. The con- 
nection to DB2 is not established. 


Programmer Response: Look up the abend 'reason-code' in 
“Section 4. DB2 Codes” for further information. The requested 
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CONNECTION NOT ESTABLISHED: DB2 condition 


'function-code' and 'return-code' may provide additional infor- 
mation. 


-925 COMMIT NOT VALID IN IMS/VS OR CICS ENVI- 


RONMENT 


Explanation: An application executing in either an IMS/VS or 
CICS environment has attempted to execute a COMMIT state- 
ment. The COMMIT statement can be issued only in a TSO 
environment. 


System Action: The statement cannot be executed. No commit 
is performed. 


Programmer Response: The !MS/VS or CICS protocols should 
be used to commit work in these environments. 


-926 ROLLBACK NOT VALID IN IMS/VS OR CICS ENVI- 


RONMENT 


Explanation: An application executing in either an IMS/VS or 
CICS environment has attempted to execute a ROLLBACK 
statement. The ROLLBACK statement can be issued only ina 
TSO environment. 


System Action: The statement cannot be executed. No roll 
back is performed. 


Programmer Response: The IMS/VS or CICS protocols should 
be used to rollback work in these environments. 


-927 THE LANGUAGE INTERFACE (LI) WAS CALLED 
WHEN THE CONNECTING ENVIRONMENT WAS 
NOT ESTABLISHED. THE PROGRAM SHOULD BE 


INVOKED UNDER THE DSN COMMAND 


Explanation: In the TSO environment, the user has attempted 
to execute an application program without first establishing the 
correct execution environment by issuing the DSN command. 
In the IMS/VS, CICS, or Call Attachment facility (CAF) environ- 
ment, the user has attempted to execute an application 
program that is not using the correct language interface 
module. 


System Action: The statement cannot be executed. 


Programmer Response: In the TSO environment, DB2 applica- 
tion programs should be invoked under the RUN subcommand 
of the DSN command processor. In the IMS/VS, CICS or CAF 
environment check that the application was link-edited with or 
is dynamically allocating the correct language interface 
module. In the IMS/VS environment, the language interface 
module required is DFSLIO00. In the CICS environment, the lan- 
guage interface module is DSNCLI. In the CAF environment, 
the language interface module required is DSNALI. In the TSO 
environment, the language interface module required is 
DSNELI. 
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Introduction 


Refer to “Section 1. Introduction” on page 1-1 fora 
description of message types and message num- 
bering conventions. 


Uniess the message is issued by a subcomponent 
operating outside the DB2 environment (such as 
the precompiler or attachment facilities), mes- 
sages are preceded by a subsystem recognition 


character that is defined during system installa- 
tion. The subsystem recognition character is not 
shown in the message texts in this book. 


In the TSO attachment facility, the user can control 
whether message IDs are displayed. To see them, 
type 'PROFILE MSGID'. To suppress them, type 
‘PROFILE NOMSGID'. 
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DSNA002E — DSNA203E 





Call Attachment Facility Messages (DSNA...) 


The call attachment facility (CAF) produces trace 
messages. They will be seen only if trace is 
turned on (that is, ddéname DSNTRACE has been 
allocated to SYSOUT or the TSO terminal). 


Notice that all call attachment facility messages 
share a basic structure. Here are the message 
elements, listed in order: 


1. Message number (DSNAnnna). 


2. The name of the CSECT responsible for writing 
the message. 


3. TCB address of the task currently executing. 


4. A series of tokens and token-explanations 
unique to each message. 


Note: The intent of these messages is to aid IBM 
development and the IBM Support Center. They 
contain information that may not be meaningful 
except to IBM. 


DSNA002E DSNACA00 TCB= address SYSTEM ERROR - 
FOUND UNEXPECTED THREAD 


Explanation: The DB2 call attachment facility control block, the 
CAB, indicated that a thread was present when none should 
have been present. This is a CAF system error. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNACA0O 


po ee eee End of Internal DB2 Information er, 


System Action: This message immediately precedes an 04E 
abend, with reason code 00010002. 


System Programmer Response: Collect a SYSUDUMP and 
DSNTRACE trace stream. 


Programmer Response: Refer the problem to your system pro- 
grammer. 


Problem Determination: Contact your IBM Support Center. 


DSNA201E DSNACA00 TCB = address CANNOT USE 
"CONNECT', ALREADY CONNECTED TO DB2 


Explanation: A CONNECT request was received but a con- 
nection to DB2 already existed for the TCB identified by 
‘address' in the message. This is a CAF error (application 
program error). The message is accompanied by return code 
(R15) 200 and code (RO) 00010201. 


[ internal DB2 Information | 
This message is issued by the following CSECT(s): DSNACAO0O 


ees End of Internal DB2 Information eee | 


System Action: No new connection is made to DB2 and an 
error return and reason code are issued. The DB2 call attach- 
ment facility is ready for more input. 


System Programmer Response: Refer the problem to the pro- 
grammer using the DB2 call attachment facility. 


Programmer Response: You must DISCONNECT the previous 
connection before you can re-CONNECT. Correct the logic in 
your code. 


Probiem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNA202E DSNACA00 TCB = address CANNOT USE 'OPEN', 
PRIOR OPEN OR SQL ALREADY CONNECTED 


APPLICATION TO DB2 


Explanation: An OPEN request was received but a DB2 thread 
had already been created for the specified TCB. This is a user 
error. The message is accompanied by return code (R15) 200 

and code (RO) 00C 10202. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNACAO0 


Ne ees End of Internal DB2 Information ee ee 


System Action: No new DB2 thread is created and an error 
return and reason code are issued. The DB2 call attachment 
facility is ready for more input. 


System Programmer Response: Refer the problem to the pro- 
grammer using the DB2 call attachment facility. 


Programmer Response: Your application program had already 
(explicitly or implicitly) established an OPEN level connection to 
DB2. You cannot do this again until the original OPEN is termi- 
nated. 'Explicit' OPENs occur when an application issues the 
call attachment facility OPEN request. 'Implicit' OPENs occur 
when an application issues SQL calls before a DB2 connection 
was established. Correct the logic in your application program. 


Problem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNA203E DSNACA00 TCB = address CANNOT USE 
"CLOSE', THERE WAS NO 'OPEN' IN EFFECT 


Explanation: A CLOSE request was received but no OPEN level 
connection (implicit or explicit) existed for this task. This is a 
user error. The message is accompanied by return code (R15) 
200 and code (RQ) 00C 10203. 
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DSNA204E — DSNA207E 


<3 ee Internal DB2 Information 7 | 
This message is issued by the following CSECT(s): DSNACA00O 


Peete ote ea End of Internal DB2 Information eee 


System Action: No CLOSE is performed. The DB2 call attach- 
ment facility is ready for more input. 


System Programmer Response: Refer the problem to the pro- 
grammer using the DB2 call attachment facility. 


Programmer Response: Correct the logic in your application. 
Do not issue CLOSE unless an explicit OPEN has been per- 
formed. ‘Explicit' OPENs occur when an application issues the 
call attachment facility OPEN request. 


Problem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNA204E DSNACA00 TCB = address CANNOT USE 
"DISCONNECT', THERE WAS NO 'CONNECT' IN 
EFFECT 


Explanation: A DISCONNECT request was received but no DB2 
connection had been established. This is a user error. The 
message is accompanied by return code (R15) 200 and code 
(RO) 00010204. 


¢—.—— internal DB2 Information al 
This message is issued by the following CSECT(s): DSNACA00O 


——— End of Internal DB2 Information Se ell 


System Action: No DISCONNECT has been performed. The 
DB2 call attachment facility is ready for more input. 


System Programmer Response: Refer the problem to the pro- 
grammer using the DB2 call attachment facility. 


Programmer Response: Correct the logic in your application. 
Do not issue DISCONNECT uniess a CONNECT has been per- 
formed. 


Problem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNA205E DSNACA00 TCB = address CANNOT USE 
"TRANSLATE ', THERE WAS NO CONNECTION TO 
DB2 OR NOTHING TO TRANSLATE 


Explanation: A TRANSLATE request was received but no data 
was available for translation. You must have valid DB2 call 
attachment facility control structures before you can make a 
TRANSLATE request. Control structures are built when you 
issue explicit or implicit connection requests. This is a user 
error. The message is accompanied by return code (R15) 200 
and code (RO) 00C 10205. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNACAOO 


a End of Internal DB2 Information copes = 
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System Action: No TRANSLATE is performed. The DB2 call 
attachment facility is ready for more input. 


System Programmer Response: Refer the probiem to the pro- 
grammer using the DB2 call attachment facility. 


Programmer Response: Correct the logic in your application. 
Do not issue TRANSLATE unless a DB2 connection has been 
attempted. 


Problem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNA206E DSNACA00 TCB = address WRONG NUMBER OF 
PARMS (number) OR VL BIT OFF 


Explanation: An erroneous DB2 call attachment facility request 
was received. The request had too many or too few parameters 
and could not be processed. The message is accompanied by 
return code (R15) 200 and code (RO) 00010206. 


| internal DB2 Information re i 
This message is issued by the following CSECT(s): DSNACAOO 


De see 8 End of Internal DB2 Information eke 


System Action: The previous request was not processed. The 
DB2 cail attachment facility is ready for more input. 


System Programmer Response: Refer the problem to the pro- 
grammer using the DB2 cal! attachment facility. 


Programmer Response: Correct the logic in your application. 
Be sure that any parameter list passed to the DB2 call attach- 
ment facility has the correct number of parameters and that the 
high order (VL) bit is turned on to end the parameter list. 


Problem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNA207E DSNACAO00 TCB = address DID NOT RECOGNIZE 
ACTION PARAMETER - parm 


Explanation: An unrecognized request type was received by 
the DB2 call attachment facility and could not be processed. 
The allowable request types are CONNECT, OPEN, CLOSE, DIS- 
CONNECT, and TRANSLATE. The message is accompanied by 
return code (R15) 200 and code (RO) 00010207. 


—-———== Internal DB2 Information ed 
This message is issued by the following CSECT(s): DSNACA0O 


—— End of Internal DB2 Information ee 


System Action: Control! returns to the caller. Your request was 
not processed. The DB2 call attachment facility is ready for 
more input. 


System Programmer Response: Refer the problem to the pro- 
grammer using the DB2 call attachment facility. 


Programmer Response: Correct the logic in your application. 
Check the spelling of the action parameter on the previous 
request passed to the DB2 cal! attachment facility. The action 
parameter you passed is listed in trace message DSNA800I. 


Problem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNA208E DSNACAO00 TCB = address CANNOT HAVE 2 SSIDS 
(ssid1 AND ssid2) FROM 1 TCB 


Explanation: An OPEN request was received specifying a dif- 
ferent subsystem identifier (ssid2) than the previous CONNECT 
request (ssid1). Your task can only be connected to a single 
DB2 subsystem. The message is accompanied by return code 
(R15) 200 and code (RO) 00010208. 


| ~~ Internal DB2 Information eS 
This message is issued by the following CSECT(s): DSNACAO0O 


a End of Internal DB2 !nformation ee 


System Action: Conirol returns to the caller. Your request was 
not processed. The DB2 call attachment facility is ready for 
more input. 


System Programmer Response: Refer the problem to the pro- 
grammer using the DB2 call attachment facility. 


Programmer Response: Specify the correct DB2 subsystem 
identifier on both the OPEN and CONNECT requests. 


Problem Determination: See a DSNTRACE trace stream to 
understand the context of this message. 


DSNAS8O00I DSNACA00 TCB = address ENTERED DSNACA00 
ACTION = action R1 = address CABPTR = address 


CABFLAG1 =flag1 CABFLAG2 = flag2 


Explanation: A DB2 call attachment facility request was 
received to perform the ‘action' function. The parameter list 
begins at location 'address' CABPTR specifies the location of 
the DB2 call attachment facility control block (the CAB). 
CABFLAG1 and CABFLAG2 are the current flag bytes. 


| == Internal DB2 Information ~~ c— 7 
This message is issued by the following CSECT(s): DSNACA0O 


ee eee End of Internal DB2 Information eases ell 


DSNA8011_ DSNACA00 TCB = address LEAVE DSNACA00 
CABFLAG1 = flag! CABFLAG2 = flag2 


CABPTR = address 


Explanation: This message is issued following completion of a 
DB2 call attachment facility request. CABFLAG1 and 
CABFLAG2 are the flag bytes and CABPTR specifies the 
location of the DB2 call attachment facility control block. 


ae ~~ Internal DB2 Information 7 Si) 
This message is issued by the following CSECT(s): DSNACAOO 


Ls End of internat DB2 Information 


DSNA208E — DSNA810I 


DSNA805| DSNACAO0O0 TCB = address CONNECT REQUEST 
SSID = ssid SECBP = ecb address TECBP = ecb 


address RIBW = address 


Explanation: A CONNECT request was received with the speci- 
fied parameter values. SSID is the subsystem identifier, SECPB 
is the DB2 start-up ECB address, TECPB is the DB2 termination 
ECB address, and RIBW is the address of the fullword that will 
be set to contain the address of the Release Information Block 
(RIB) after the CONNECT completes. 


ae Internal DB2 Information OM 
This message is issued by the following CSECT(s): DSNACAO0O 


[Seneca End of Internal DB2 Information et a 


DSNA806f DSNACA00 TCB = address DISCONNECT 


REQUEST 


Explanation: A DISCONNECT request was received for the 
specified TCB. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNACAOO 


{| snd of Internal DB2 Information 


DSNA8071 DSNACAO00 TCB = address OPEN REQUEST 


SSID=ssid PLAN =plan name 


Explanation: An OPEN request was received with the specified 
SSID and PLAN values. 


[p= ee Internal DB2 Information a = es | 
This message is issued by the following CSECT(s): DSNACA0O 


rn End of Internal DB2 Information | 


DSNA808i DSNACAO00 TCB= address CLOSE REQUEST 


TRMOP = terminate option 


Explanation: A CLOSE request was received with the specified 
termination option. 


Internal DB2 Information aE 
This message is issued by the following CSECT(s): DSNACA00 


oa End of Internal DB2 Information Pe eee ee 


DSNA8101 csectname TCB=address BEFORE 


function = = ========s=== 


Explanation: This message is issued by the DB2 call attach- 
ment facility before a ‘function’ request to DB2. This is the last 
DB2 call attachment facility action performed before passing 
control to DB2 for processing. If this is the last DB2 call attach- 
ment facility message before an abend, then the abend very 
probably occurred in the DB2 code itself, rather than in the DB2 
call attachment facility code. 
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DSNA811i — DSNA825I 


wr ~~ interna! DB2 Information : ” : 


This message is issued by the following CSECT(s): DSNACAOO, 
DSNACA70 


(oe ns End of Internal DB2 Information eet el) 


DSNA811I csectname TCB = address AFTER 


function = = = ========+== 


Explanation: This message is issued by the DB2 call attach- 
ment facility when DB2 returns control after a 'function' 
request. 


| Internal DB2 Information ~~~ ral 


This message is issued by the following CSECT(s): DSNACAOO, 
DSNACA70 


Oe eee End of Internal DB2 Information ae ere, 


DSNA8131 csect-name TCB = address FRBP = address 
RAL = data RALE = data FVLE = data PARM = data 


PCNT = data 


Explanation: This message, along with message DSNA814I, 
displays the contents of the FRB control block before or after a 
call to DB2. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): DSNACAOO, 
DSNACA70 


a End of Internal DB2 information potion Ste i 


DSNA814i csect-name TCB = address RC1 = retcode 
RC2=retcode FBACK = feedback RHPC = data 


QUAL = data RSV1 = data 


Explanation: This message, along with message DSNA813I, 
displays the contents of the FRB control block before or after a 
call to DB2. 


[ Internal DB2 Information — oy i 


This message is issued by the following CSECT(s): DSNACAOO, 
DSNACA70 


eee End of Internal DB2 Information ae, 


DSNA821I DSNACA0O TCB = address IMPLICIT CONNECTION 


REQUEST 


Explanation: An SQL request was received before establishing 
the DB2 connection. This results in an implicit connection to 
DB2 using a default for the application plan name. If no 
CONNECT was issued, it also results in a default for the DB2 
subsystem identifier. 
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| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNACA0O 


Heo en End of Internal DB2 Information es: 


DSNA822I DSNACAO00 TCB = address TRANSLATE REQUEST 
SQLCA= address CABFRC1 = retcode 


CABFRC2=retcode FRBRHPC = frbrhpc 


Explanation: The DB2 call attachment facility received a 
TRANSLATE request. This message identifies the location of 
the SQLCA whose SQLCODE field will be set and the return 
codes that will be translated. The translate will not be per- 
formed if FRBRHPC is zero. 


internal DB2 Information | 
This message is issued by the following CSECT(s): DSNACAO0O 


Wear emer End of Internal DB2 Information _ 


DSNA8231 DSNACA70 TCB= address CODE LEVEL MIS- 


MATCH CAF =release DB2=release 


Explanation: A release level mismatch between the DB2 Call 
Attachment Facility and DB2 has been encountered after.a suc- 
cessful CONNECT to DB2. 


System Action: A return code of 4 (R15), and a reason code of 
00C 10823 (RO) is returned to the caller’s application program. 


User Response: The application program may continue proc- 
essing if the system programmer has determined that the differ- 
ences between the DB2 releases will not cause unpredictable 
results. 


Problem Determination: This problem may be caused by 
improper DB2 data set allocation in a LOGON procedure or 
CLIST. 


DSNA824l DSNACA70 TCB= address CAF READY FOR NEW 


CONNECTION SERVICE REQUESTS 


Explanation: This message indicates that the previous DB2 
connection has been terminated, certain clean-up processing 
has occurred, and that the DB2 call attachment facility is now 
ready to process additional connection requests. The message 
is accompanied by return code (R15) 4 and code (RO) 00C 10824. 


Internal DB2 Information a ~ | 
This message is issued by the following CSECT(s): DSNACA70 


eee: End of Internal DB2 Information Seeeeeeeta| 


DSNA825I DSNACA70 TCB=address CABSSID = ssid 


CABREL = release CABDECPP = address 


Explanation: This message lists the current values in 
DSNHDECP, which is loaded by the DB2 call attachment facility. 
These values will be used as defaults on implicit connection 
requests. 


| Internal DB2 information Fe ee | 
This message is issued by the following CSECT(s): DSNACA70 


[oo End of Internal DB2 Information ee eee 


DSNA8261 DSNACAO00 TCB = address BEFORE VALIDITY 


CHECKING THE type ECB AT ADDRESS location 


Explanation: This trace message indicates that a check of the 
‘type' ECB (either start-up or shutdown), is about to be done to 
determine if the address identified by 'Jocation' is addressable. 
If an 0C4 abend occurs immediately following this message, 
then you have passed an invalid ECB address on a CONNECT 
request. 


an Internal DB2 Information rege Se eT 
This message is issued by the following CSECT(s): DSNACAOO 


a End of Internal DB2 Information eee ae 


DSNA8271 DSNACA00 TCB=address AFTER VALIDITY 


CHECKING THE type ECB WHICH CONTAINS data 


Explanation: This trace message indicates that the identified 
ECB is addressable and contains the specified data value. 
Appearance of this message is not a guarantee that the ECB 
address you passed is valid; it has only passed preliminary 
tests. If you delete this ECB without DB2’s knowledge, it will no 
longer be a valid ECB. 


| Internal DB2 Information ~—— ~ | 
This message is issued by the following CSECT(s): DSNACAOO 


{ End of Internal DB2 Information ee! 


DSNA828I DSNACA70 TCB = address RIB ADDRESS = ribaddr 


RIBPTR ADDR = ribptr 


Explanation: This trace message lists the address of the DB2 
Release Information Block (ribaddr) and the address of the 
fullword that points to the RIB (ribptr) after connection attempts 
were made to a DB2 subsystem. 


[ ~~~ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNACA70 


ee End of Internal DB2 Information eee 


DSNA8291 DSNACA00 TCB = address R1(FRB) =frbaddr 
SQLDSECT(FRBPARM) = dsectaddr RDI=rdiaddr 


SQLCA = sgqicaaddr CABFLAG2=flag2 


Explanation: This trace message lists the addresses of the 
FRB, the SQLDSECT, the RDI, and the SQLCA. The CABFLAG2 
flag byte is the last token. 


DSNA826!I — DSNA830I 


| = Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNACAOO 


(ee End of Internal DB2 Information ee, 


DSNA830!1 DSNACA00 TCB = address SQLCODE = sqicode 


CABFLAG1 =flag! CABFLAG2 =flag2 


Explanation: This trace message lists the SQLCODE and the 
two call attachment facility flag bytes. 


aa Internal DB2 information | 
This message is issued by the following CSECT(s): DSNACAOO 


ee End of internal DB2 Information i eects 8 


Section 3. DB2 Messages 3-9 


DSNB204I — DSNB212I 





Buffer Manager Messages (DSNB...) 


DSNB204i OPEN OF DATA SET FAILED. DSNAME = dsn 


Explanation: A required data set of a DB2 table or index space 
could not be opened. The error was detected by the media 
manager CONNECT function that issues system message 
IEC161|. The 'dsn' indicates the DSNAME of the data set. 


SS internal DB2 Information Ge ee el 
This message is issued by the following CSECT(s): DSNB1OST 


[tt he oe End of Internal DB2 Information _ 


System Action: Buffer manager functions that detect this condi- 
tion terminate. 


Operator Response: Notify the system programmer. 


System Programmer Response: To determine the cause of the 
error, refer to system message IEC161I in the appropriate MVS 
publication. Correct the error, and then reinvoke the applica- 
tion. 


Problem Determination: See the problem determination infor- 
mation associated with system message IEC1611 in the appro- 
priate MVS publication. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 10, 11. 


DSNB2071 DYNAMIC ALLOCATION OF DATA SET FAILED. 


REASON = rrrr DSNAME = dsn 


Explanation: A required data set of a DB2 table or index space 
could not be allocated. The 'rrrr' indicates the reason for the 
failure. The 'dsn' indicates the data set’s DSNAME; it is the 
error reason code returned by dynamic allocation. Refer to the 
appropriate MVS publications for a description of these reason 
codes. 


ne Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNB1OST 


ee End of interna! DB2 Information eee 


System Action: Buffer manager functions that detect this condi- 
tion terminate and pass a unique error return code. 


Operator Response: Notify the system programmer. 


System Programmer Response: Correct the situation, and then 
reinvoke the application. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5, 10, 11. 


DSNB209I_ _—s csect-name — BUFFER MANAGER 
TABLESPACE/INDEXSPACE CLEAN — UP ROUTINE 
(DSNB1CFC) HAS BEEN SCHEDULED FOR 
DBNAME = dbn, SPACENAME = spn, PSID = 


X'psid' 


Explanation: The buffer manager (BM) subcomponent of DB2 
detected an abnormal condition. The associated table space or 
index space contains modified pages that cannot be written out 
to DASD for a period of time that is longer than was expected. 
This may be caused by either unbalanced write intents 
resulting from logical errors on the page or by an internal logic 
error. 


The buffer manager has scheduled the table space or index 
space cleanup routine (DSNB1CFC) for the associated table 
space or index space. DSNB1CFC acquires an exclusive table 
space or index space lock to ensure that no updates are in 
progress. Data is inaccessible to users during the cleanup 
process. 


For recoverable inconsistent pages with unbalanced write 
intents, the buffer manager initiates the recovery process and 
reconstructs the pages using the DB2 log. For other modified 
pages with unbalanced write intents, the buffer manager forces 
the pages to be written back to DASD and then makes the buffer 
space available for reassignment. 


The 'dbn' indicates the database name with which the table 
space or index space is associated. The 'spn' is the name of 
the table space or index space that must be cleaned up. The 
‘psid' is the internal identifier for the table space or index 
space; it is used to associate this message with a follow-on 
message, DSNB221I, that may be issued. 


TS Internal DB2 Information Fao | 


This message is issued by the following CSECT(s): DSNB1CHK, 
DSNB1RTR 


a End of Internal DB2 Information eee 


System Action: DB2 is ready to clean up the associated table 
space or index space. All activities against the table space or 
index space are quiesced prior to the cleanup process. In addi- 
tion, if the associated object is an index space, all activities 
against the table space for which the index space is defined are 
also quiesced. After the cleanup process completes, the table 
space or index space is automatically made accessible to 
users. 


DSNB212I1 ~=csect-name — RECOVER PAGE STARTING 
DBNAME = dbn , SPACENAME = spn , PAGE 


NUMBER = X'pno' 


Explanation: The buffer manager (BM) subcomponent of DB2 
has discovered an inconsistent page with unbalanced write 
intents. DB2 is ready to do online recovery on the page using 
the DB2 log. The 'dbn' indicates the associated database 
name. The 'spn' indicates the table space name or index 
space name. The 'pno' is the page number (in hexadecimal) 
within the table space or index space that is logically incon- 
sistent. 
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DSNB215!1 — DSNB223!I 


aan a internal DB2 Information | 


This message is issued by the following CSECT(s): DSNB1CFC, 
DSNB1CPP 


ee End of Internal DB2 Information. id 


System Action: Processing continues. 


DSNB215!1 ~—s csect-name — ONLINE RECOVERY FOR AN INCON- 
SISTENT PAGE HAS BEEN COMPLETED FOR 
DBNAME = dbn , SPACENAME = spn, PAGE 


NUMBER = X'pno' 


Explanation: The recovery process for an inconsistent page 
has been completed. The 'dbn' indicates the associated data- 
base name. The 'spn' indicates the table space name or index 
space name. The 'pno' is the page number (in hexadecimal) 
within the table space or index space that was logically incon- 
sistent. 


| Internal DB2 Information - | 


This message is issued by the following CSECT(s): DSNB1CFC, 
DSNB1CPP 


beeen End of Internal DB2 Information eee a | 


System Action: Processing continues. 


DSNB217! csect-name — ONLINE RECOVERY FOR AN INCON- 
SISTENT PAGE WAS UNSUCCESSFUL FOR 
DBNAME = dbn , SPACENAME = spn, PAGE 


NUMBER = X'pno' 


Explanation: The recovery process for an inconsistent page 
has failed. The page is written out to DASD as logicaily incon- 
sistent. This message is issued in response to the message, 
DSNB212l, that was issued to indicate the start of the recovery 
process. The 'dbn' indicates the associated database name. 
The 'spn' indicates the table space name or index space 
name. The 'pno' is the page number (in hexadecimal) within 
the table space or index space that was logically inconsistent. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNB1CFC, 
DSNB1CPP 


(ae ee End of Internal DB2 Information ee 


System Action: The page is marked as logically inconsistent 
and is unavailable until it is repaired. The execution unit 
driving this function proceeds normally. 


Problem Determination: A DSNI012! message may be issued 
prior to this message to indicate the same failure. If itis, a 
'00C90102' abend dump may help determine the cause of this 
failure. Otherwise, see the SYS1.LOGREC for any abend that 
occurred between the associated DSNB212I message and this 
message. Use the time stamp on the log records to find this 
abend. 
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DSNB2191 ~—s csect-name — BUFFER MANAGER 
TABLESPACE/INDEXSPACE CLEAN — UP 
PROCESS HAS BEEN COMPLETED FOR DBNAME 


= dbn , SPACENAME = spn 


Explanation: This message indicates that the buffer manager 
(BM) table space or index space cleanup process has been 
completed for the associated table space or index space. Refer 
to message DSNB209I for the reasons why the buffer manager 
schedules the table space or index space cleanup process. 

The 'dbn' indicates the associated database name. The ‘spn' 
indicates the table space name or index space name. 


| — Internal DB2 Information ~~ “| 
This message is issued by the following CSECT(s): DSNB1CFC 


fee oe End of Internal DB2 Information SS ae 


System Action: Processing continues. 


DSNB221I ~—scsect-name — BUFFER MANAGER 
TABLESPACE/INDEXSPACE CLEAN — UP 
PROCESS WAS NOT REQUIRED FOR PSID = 


X'psid' 


Explanation: This message indicates that the buffer manager 
(BM) table space or index space cleanup process has been 
bypassed for the associated table space or index space. After 
quiescing all other activities against the table space or index 
space, the buffer manager has discovered that the table space 
or index space is no longer in active mode; that is, it has been 
closed. 


The abnormal condition detected earlier has been resolved by 
buffer manager close page set processing. Refer to the corre- 
sponding message, DSNB209l, using 'psid' as the matching 
field, for the reasons the buffer manager schedules the table 
space or index space cleanup process. The 'psid' is the 
internal identifier for the associated table space or index space. 


| Internal DB2 Information ie gee 
This message is issued by the following CSECT(s): DSNB1CFC 


ae ee End of Internal DB2 Information tg te ot 


System Action: Processing continues. 


DSNB223I_ _—scsect-name — BUFFER MANAGER 
TABLESPACE/INDEXSPACE CLEAN — UP 


PROCESS WAS SKIPPED FOR PSID = X'psid' 


Explanation: This message indicates that the buffer manager 
(BM) table space or index space cleanup process has been 
bypassed for the associated table space or index space. 
During the process of quiescing all other activities against the 
table space or index space, an error that is not recoverable 
was detected. The error might be caused by any of the fol- 
lowing conditions: 


¢ An out-of-storage condition was detected by IRLM. 

e An internal error was detected in data manager DSNIPSCB 
processing. 

¢ The table space or index space is allocated to a DB2 utility 
function. 

¢ The table space or index space has been dropped because 
of a backout. 


It is assumed that the abnormal condition detected earlier can 
later be resolved by the buffer manager close page set proc- 
essing. Refer to the corresponding message DSNB209! (use 
‘psid' as the matching field) for the reasons for scheduling the 
buffer manager table space or index space cleanup process. 
The 'psid' specifies the internal identifier for the associated 
table space or index space. 


| ioe ~ Internal DB2 Information ~~~ el 
This message is issued by the following CSECT(s): DSNB1CFC 


————s End of Internal DB2 Information See! 


System Action: Processing continues. 


System Programmer Response: The associated table space or 
index space may contain inconsistent data. If the table space 
or index space is defined as CLOSE (NO), issue the DB2 STOP 
TABLESPACE or INDEXSPACE command to allow buffer 
manager close page set processing to perform cleanup for the 
associated table space or index space. 


DSNB2241_ ~=csect-name — BUFFER MANAGER I/O ERROR 
DURING function, 

DBNAME = dbn,SPACENAME = snm, DATA SET 
NUMBER = dsno,PAGE NUMBER = X'pno',MM 
ERROR FLAG = X'aa',CSW 

STATUS = X'bbbb' SENSE BYTES = X'cccc', 


SEEK ADDRESS = X'dddddddddddddddd' 


Explanation: An I/O error was encountered by the buffer 
manager (BM) subcomponent of DB2. The function specified in 
the message will be 'READ', 'WRITE', 'FORMAT', or 
‘PREFETCH'. The message gives the database name, table 
space name or index space name, data set number, and page 
number (in hexadecimal) of the page for which the I/O opera- 
tion was being performed. The remaining information is error 
information returned by the media manager and is used for 
error analysis by IBM support personnel. 


[ : = Internal DB2 information 
This message is issued by the following CSECT(s): DSNB1AEX 


[Pei cece fore End of Internal DB2 Information ee 


System Action: The system action will depend on the function 
being performed. If the function is ‘'READ' or 'WRITE', the i/O 
error page range of the data set will be updated and a 
DSNU086! message will be issued. In most cases (READ, syn- 
chronous WRITE, FORMAT), a 'resource not available’ will be 
returned to the user with a reason code that identifies the 
nature of the problem. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: See documeniation in 
“Section 4. DB2 Codes” on page 4-1 for the reason code 
returned to the user in SQLCA or in Utility messages. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: See the problem determination 
section of the reason code returned to user. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


DSNB2241 — DSNB60TI 


DSNB227! csect-name - DFHSM RECALL FAILED FOR 
DSNAME = dsn HSMRC = aaaaaaaa 


HSMRSN = bbbbbbbb 


Explanation: The attempt to recall a migrated data set has 
failed. DSNAME identifies the data set. HSMRC and HSMRSN 
are the return code and reason code given by DFHSM. 


TO _ internai DB2 Information | 
This message is issued by the following CSECT(s): DSNB1RST 


———— aes End of Internal DB2 Information eee 


System Action: A ‘resource not available' code is returned to 
the user. 


Operator Response: Notify the system programmer. 


System Programmer Response: Use the information provided 
in the message to determine the reason for the DFHSM recall 
failure. 


Problem Determination: Refer to “Section 4. DB2 Codes” on 
page 4-1 for an explanation of the return and reason codes 
contained in this message. The DFHSM message to refer to is 
ARC1innl, where nn is the value of HSMRC. 


DSNB601l BUFFER POOL nn FULL 


Explanation: A buffer is required to access a database page 
that is not currently contained within the buffer pool. A buffer 
cannot be assigned, because all buffers of the pool are ina 
nondisplaceable state. (Buffers are in a nondisplaceable state 
when they contain actively referenced pages or updated pages 
for which writes are pending.) In addition, the buffer pool 
cannot be expanded, either because insufficient virtual storage 
exists, or because the buffer pool has already reached its 
maximum allowable size. 


This message can occur if there is an overload of activity for 
the buffer pool size. The variable 'nn' identifies the buffer 
pool. 


Ne internal DB2 Information Sw 
This message is issued by the following CSECT(s): DSNB1GET 


ete End of Internal DB2 Information Rate tae 


System Action: Reason code '00C200E8' or '00C200E9' and 
the buffer pool ID are recorded in the cursor table (CT), which is 
available in the SQL communication area (SQLCA) or in mes- 
sages. A 'resource not available' code is returned to the user. 


Operator Response: Notify the system programmer. 


System Programmer Response: Reduce activity by reducing 
the number of DB2 threads, or, if necessary, stop DB2 and 
increase the buffer pool maximum size via either the 'BUFFER' 
parameter of the DSN6SPRM assembler macro in the DSNTIJUZ 
job stream or the DB2 installation storage sizes panel 
(DSNTIPES). Then, resubmit the installation job, DSNTIJUZ, 
specifying the name of the load module that is specified after 
the 'PARM= ' parameter of the -START DB2 command in the 
"NAME' parameter of the link-edit SYSIN. 


Problem Determination: if the SQLCA contains the reason 
code '00C200E8', it indicates that the buffer pool cannot be 
expanded, because insufficient virtual storage exists. If SQLCA 
contains the reason code '00C200E9’, it indicates that the 


DB2 Messages 3-13 


DSNB6021 — DSNB605I 


buffer pool cannot be expanded, because it has already 
reached its maximum size. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 9. 


DSNB602I UNABLE TO CREATE BUFFER POOL nn, BUFFER 


POOL SIZE NOT INITIALIZED 


Expianation: An attempt to create buffer pool 'nn' failed while 
opening a DB2 table space or index that specified its use. The 
minimum size for buffer pool 'nn' specified by the BUFFER 
parameter of the DSN6SPRM assembler macro was found to be 
zero. This indicates that the use of the pool is invalid. 


[ Internal DB2 Information —7 
This message is issued by the following CSECT(s): DSNB10PS 


cee > oe oe End of Interna! DB2 Information pee eet 


System Action: The table space or index that is open is termi- 
nated. The buffer manager returns to its calling subcomponent, 
which normally provides a message that is accompanied by 
reason code '00C200E0'. This reason code is described in 
“Section 4. DB2 Codes” on page 4-1. 


Operator Response: Notify the system programmer. 


System Programmer Response: Use the ALTER TABLESPACE 
or ALTER INDEX statements to indicate a usable buffer pool. If 
necessary, stop DB2, and set the number of buffers desired 
using either the BUFFER parameter of the DSN6SPRM assem- 
bler macro in the DSNTIJUZ job stream or the DB2 installation 
storage sizes panel (DSNTIPES). Then, resubmit the installa- 
tion job, DSNTIJUZ, specifying the name of the load module that 
is specified after the PARM= parameter of the -START DB2 
command in the NAME parameter of the link-edit SYSIN. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
9. 


DSNB6031 UNABLE TO CREATE BUFFER POOL nn. INSUFFI- 


CIENT VIRTUAL STORAGE 


Explanation: An attempt to create buffer pool 'nn' failed while 
opening a DB2 table space or index. Insufficient virtual storage 
exists within the database address space for the buffers speci- 
fied in the BUFFER parameter of the DSN6SPRM assembler 
macro in the DSNTIJUZ job stream. 


3-14 DB2 Messages and Codes 


| internal DB2 Information — | 
This message is issued by the following CSECT(s): DSNB10PS 


[| End of Internal DB2 Information | 


System Action: The table space or index open is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Analyze the virtual storage 
content of the database address space to determine further 
action. If appropriate, use the ALTER TABLESPACE or ALTER 
INDEX statements to indicate use of a different buffer pool. Oth- 
erwise, if necessary, stop DB2, and then reduce the number of 
buffers of this and/or other buffer pools using either the 
BUFFER parameter of the DSN6SPRM assembler macro in the 
DSNTIJUZ job stream or the DB2 installation storage sizes 
panel (DSNTIPES). Then, resubmit the installation job, 
DSNTIJUZ, specifying the name of the load module that is speci- 
fied after the PARM= parameter of the -START DB2 command 
in the NAME parameter of the link-edit SYSIN. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
9. 


DSNB605I UNABLE TO EXPAND BUFFER POOL nn TO 
RECORDED SIZE 


INSUFFICIENT VIRTUAL STORAGE 


Explanation: An attempt to expand the buffer pool identified in 
the message as 'nn' from its startup/restart default value to its 
installation-specified value failed during end/restart proc- 
essing. Insufficient virtual storage exists within the database 
storage for the additional buffers required. 


| internal DB2 Information : | 
This message is issued by the following CSECT(s): DSNB1PM2 


ee End of Internal DB2 Information Cnr tines E] 


System Action: The buffer pool is restored to its startup/restart 
default values. The end/restart function proceeds normally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Analyze the virtual storage 
content of the database address space to determine further 
action. If necessary, stop DB2, and then reduce the number of 
buffers of this or other buffer pools using either the BUFFER 
parameter of the DSN6SPRM assembler macro in the DSNTIJUZ 
job stream or the DB2 installation storage sizes panel 
(DSNTIPES). Then, resubmit the installation job, DSNTIJUZ, 
specifying the name of the load module that is specified after 
the PARM= parameter of the -START DB2 command in the 
NAME parameter of the link-edit SYSIN. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
9. 


DSNC — DSNCOO6I 





CICS Attachment Facility Messages (DSNC...) 


DSNC 


Explanation: This is a CICS transaction abend/dump code, not 
a DB2 message. Refer to Appendix A, “CICS Transaction 
Abend/Dump Code (DSNC)” on page X-3 for a complete expla- 
nation. 


DSNCOO1! CICS UR INDOUBT RESOLUTION tS INCOMPLETE 


FOR name 


Explanation: CICS cannot resolve the disposition of the units of 
recovery that DB2 holds indoubt from the previous connection, 
because CICS was cold started. 


| | Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCEXT1 


Oe eeeoeeeee End of Internal DB2 Information ee) 


System Action: The CICS attachment facility continues the 
startup process normally. 


Operator Response: Notify the CICS system programmer. 


System Programmer Response: The final disposition of the 
indoubt units of work must be specified to DB2 manually using 
the -DISPLAY THREAD and -RECOVER INDOUBT commands 
provided by DB2. 


DSNC002i_ DSNCRCT n MODULE NOT FOUND 


Explanation: The resource control table (RCT) with suffix spec- 
ified in the message (as 'n') could not be loaded. 


| == Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCSTRT 


cae End of Internal DB2 Information Pre ee 


System Action: The CICS attachment facility initialization is ter- 
minated. 


Operator Response: Reenter the start command with the 
correct suffix. 


System Programmer Response: Ensure that the resource 
control table (RCT) is in the correct application program library 
and that it is concatenated to the JOBLIB, STEPLIB, or MVS 
LINK library. 


DSNC003] THE ATTACHMENT FACILITY IS ALREADY ACTIVE 


Explanation: The CICS attachment facility is already active and 
enabied to CICS. , 


| Internal DB2 Information TES ee So 


This message is issued by the following CSECT(s): DSNCCOM1 


Ue oe ae End of Internal DB2 Information sel 


System Action: The CICS attachment facility initialization is ter- 
minated. 


Operator Response: Only one occurrence of the CICS attach- 
ment facility is permitted. 


DSNCO004i THE PLAN NAME IS NOT FOUND IN THE RCT 


Explanation: This message is in response to a DSNC DISPLAY 
or DSNC DISCONNECT command. The plan named in the 
command could not be found in the resource control table 
(RCT). 


internal DB2 Information - | 
This message is issued by the following CSECT(s): DSNCCOM1 


[send of Internal DB2 Information 


System Action: The CICS attachment facility command is not 
processed. 


Operator Response: Reenter the command with the correct 
plan name. 


DSNCO005I THE TRANSACTION NAME IS NOT FOUND IN THE 


RCT 


Explanation: This message is in response to a DISPLAY or 
MODIFY command. The transaction named in the command 
could not be found in the resource control table (RCT). 


[~ Internal DB2 Information 2 ey 
This message is issued by the following CSECT(s): DSNCCOM1 


re End of Internal DB2 Information ae 


System Action: The CICS attachment facility command is not 
processed. 


Operator Response: Reenter the command with the correct 
transaction name. 


DSNCO06I 


Explanation: This message is issued in response to a CICS 
attachment facility command. The destination ID named in the 
command (and specified in the message as 'dest') could not be 
found in the CICS destination control table (DCT) or the 
resource control table (RCT). 


THE dest DESTINATION ID IS INVALID 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCCOM1 


ae tne End of Internal DB2 Information goer hae 


System Action: The CICS attachment facility command is not 
processed. 


Operator Response: Reenter the command with the correct 
destination ID. 
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DSNC007I — DSNC013! 


DSNC0071 THE COMMAND VERB IS MISSING OR INVALID 


Explanation: The CICS attachment facility cannot recognize the 
action keyword of the input command. 


| internal DB2 Information —— en 
This message is issued by the following CSECT(s): DSNCCMDP 


[| End of Internal DB2 Information 


System Action: The command is not processed. 


Operator Response: Reenter the command with the correct 
syntax. 


DSNCO08i KEYWORD IS MISSING OR INVALID 


Explanation: A CICS attachment facility command was entered. 
Either the command contained a positional keyword that is 
unknown to the command processor, or a keyword was omitted. 


| <= Internal DB2 Information 
This message is issued by the following CSECT(s): DSNCCMDP 


LE nd of Internal DB2 Information ______| 


System Action: The command is not processed. 


Operator Response: Reenter the command with the correct 
syntax. 


DSNCOO9I =©9THE VALUE IN THE COMMAND IS INVALID 


Explanation: The numeric value in the DSNC MODIFY 
command may be invalid. Otherwise, the error is caused by 
one of the following: 


* The value is greater than the value specified for the THRDM 
parameter in the resource control table (RCT). 

e Ifthe POOL RCT entry is being changed, the active thread 
count cannot be set to less than 3. 


fea ae internal DB2 Information nia 
This message is issued by the following CSECT(s): DSNCCOM1 


ie ee tes End of Internal DB2 Information zs Pe) 


System Action: The command is not processed. 
Operator Response: Reenter the command with a valid value. 


System Programmer Response: ifthe number of threads 
required is more than the number allowed for in the resource 
control table (RCT), then regenerate the table with a larger 
number of threads specified by the THRDM parameter. 
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DSNCO11i = tran TRANSACTION ABENDED BECAUSE 


THREADS ARE UNAVAILABLE 


Explanation: The transaction indicated in the error message 
was abnormally terminated, because a thread connection to 
DB2 was not available for the transaction. The variable 'tran' 
is the.CICS transaction ID. This error message can occur when: 


© TWAIT of the transaction entry in the resource control table 
is equal to 'NO'. 

¢ TWAIT of the transaction entry is 'POOL', TWAIT in the pool 
entry is 'NO', and all threads in the POOL are active. 


| internal DB2 information | 
This message is issued by the following CSECT(s): DSNCEXT1 


een End of Internal DB2 Information are 


System Action: The indicated transaction is abended. No other 
action is taken by the CICS attachment facility 


Operator Response: Notify the CICS system programmer. 


System Programmer Response: Determine which of the fol- 
lowing actions will correct the problem: 


e If more threads are available with current generation of the 
resource control table (RCT), instruct the master terminal 
operator to make more threads active, by using the CICS 
attachment facility MODIFY command. 

¢ Regenerate the resource control table and make more 
threads available to the transaction that failed. Stop and 
then restart the CICS attachment facility to make the new 
resource control table active. 


DSNCO12i. 3=THE ATTACHMENT FACILITY STOP QUIESCE IS 


PROCEEDING 


Explanation: A STOP QUIESCE command is being processed. 
This command was entered by the master terminal operator. 


| oa : internal DB2 Information | 
This message is issued by the following CSECT(s): DNSCCOM1 


(eee End of Internal DB2 Information eee al 


System Action: The CICS attachment facility releases the ter- 
minal entering the command and proceeds with the quiesce 
process. If the quiesce is not completed within the required 
time period, a STOP FORCE command can be entered. 


DSNC0131 DISPLAY REPORT FOLLOWS 


Explanation: A CICS attachment facility display was requested 
and follows this message. 


| conan Internal DB2 Information ~~ aa 
This message is issued by the following CSECT(s): DSNCCOM1 


es End of Internal DB2 Information hee eee , 


System Action: Processing continues normally. 


DSNC0141 STATISTICS REPORT FOR rct-name FOLLOWS 


Explanation: A CICS attachment facility statistics display was 
requested and follows this message. The name of the RCT that 
is currently in use is 'rct-name'. 


[ ~ internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCCOM1 


aes End of Internal DB2 Information pete tee 


System Action: Processing continues normally. 


DSNC0161 THE CONNECTION OF CICS TO name FAILED 


Explanation: The CICS attachment facility is abnormally termi- 
nating, because an error has occurred in the process of con- 
necting with DB2. 


oe Internal DB2 Information oa 
This message is issued by the following CSECT(s): DSNCSTRT 


[| End of Internal DB2 Information are 


System Action: The CICS attachment facility terminates with an 
abend completion code of X'04E' and one of the following 
reason codes: 00030002, 00C30003, 00C30006, 00C30007, 
00C30008, or 00C30009. If the initial identify fails because of an 
authorization error, DSNC042lI is issued and no dump is 
requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: The abend dumps associated 
with this message must be analyzed to determine the source of 
the error. Refer to the description of message DSNC042I. 


DSNC0O171 3=ATTACHMENT OF A THREAD SUBTASK FAILED 


Explanation: The CICS attachment facility continues proc- 
essing but is unable to start as many thread subtasks as are 
allowed in a resource control table (RCT) entry. 


eo Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCEXT2 


[eet Seance ace End of Interna! DB2 Information _ 


System Action: The CICS attachment facility attempted to ter- 
minate all subtasks that are currently unused, but none could 
be terminated. If other subtasks are not active to process the 
current transaction, CICS is requested to abend the transaction. 


Operator Response: Notify the system programmer. 


System Programmer Response: The error may be caused by 
either of the following: 


¢ There is a shortage of storage in the local storage queue 
area (LSQA). 

¢ The total maximum number of thread subtasks allowed has 
been attained. The maximum is specified in the THRDMAX 
parameter of the resource control table (RCT). The CICS 
attachment facility DISPLAY STATISTICS command can be 
useful in analyzing the current thread usage. 


DSNCO014I — DSNC022I 


DSNCO18I_ =name IS NOT ACTIVE 


Explanation: The CICS attachment facility STRT command 
cannot proceed, because the subsystem specified in the 
message (as 'name’') is not active. 


aie Internal DB2 Information hare 
This message is issued by the following CSECT(s): DSNCSTRT 


Lees Pas End of Internal DB2 tnformation _ 


System Action: The CICS attachment facility STRT command 
completes processing. 


Operator Response: Reenter the CiCS attachment facility 
command after DB2 has been started. 


DSNCO191 THE MODIFY COMMAND IS COMPLETE 


Explanation: The CICS attachment facility MODIFY command 
has successfully completed processing. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNCCOM1 


eae End of Internal DB2 Information fe 


System Action: The CICS attachment facility MODIFY command 
completes processing. 


DSNCO201 THE DISPLAY COMMAND IS COMPLETE 


Explanation: The CICS attachment facility DISPLAY command 
has successfully completed processing. 


[ Internal DB2 Information See 
This message is issued by the following CSECT(s): DSNCCOM1 


Whe ear End of Internal DB2 Information See 


System Action: The CICS attachment facility DISPLAY 
command completes processing. 


DSNC021i THE DISCONNECT COMMAND IS COMPLETE 


Explanation: The CICS attachment facility DISCONNECT 
command has successfully completed processing. 


ae Internal DB2 information es ae 
This message is issued by the following CSECT(s): DSNCCOM1 


ae rr, End of internal DB2 Information er ee 


System Action: The CICS attachment facility DISCONNECT 
command completes processing. 


DSNCO022i 3 =THE ATTACHMENT FACILITY STOP FORCE IS 


PROCEEDING 


Explanation: A STOP FORCE command is being processed. 
This command was entered by the master terminal operator. 
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DSNC023! — DSNC028I 


Internal DB2 Information : | 
This message is issued by the following CSECT(s): DSNCCOM1 


ee anes End of Internal DB2 Information ees te 


System Action: The CICS attachment facility releases the ter- 
minal entering the command and proceeds with the STOP 
FORCE process. 


THE ATTACHMENT FACILITY HAS CONNECTED 
TO name USING rct-name 


DSNCO23) 


Explanation: The CICS attachment facility STRT command has 
successfully completed processing, and subsystem ‘name' is 
now available to CICS. The name of the RCT that was specified 
for this start of the CICS attachment facility is 'rct-name'. 


[ = Internal DB2 Information | 


This message is issued by the following CSECT(s): 
DSNCCOM1, DSNCEXT2 


ee End of Internal DB2 Information _ 


System Action: The CICS attachment facility STRT command 
completes processing, leaving the CICS attachment facility 
active. 


DSNCO241 dest CANNOT BE LOCATED IN THE DCT 


Explanation: The destination shown in the message cannot be 
located in the CICS destination control table (DCT). 


[ — Internal DB2 Information I 
This message is issued by the following CSECT(s): DSNCCOM1 


—— or End of Internal DB2 Information See 


System Action: The CICS attachment facility startup process 
continues. The destination entry in the resource control table 
(RCT) is set to '*' for potential modification by the CICS aittach- 
ment facility. 


Operator Response: Notify the system programmer, and use 
the CICS attachment facility MODIFY command to set the error 
destination to the correct identification characters. 


System Programmer Response: Correct either the RCT or the 
DCT to synchronize the error destinations. 


DSNCO025I THE ATTACHMENT FACILITY IS INACTIVE 


Explanation: This is the final message issued by the CICS 
attachment facility informing resource control table error desti- 
nations that the CICS attachment facility has completed the 
shutdown process. 


[ Internal DB2 Information ; = 
This message is issued by the following CSECT(s): DSNCSTOP 


ea ore End of Internal DB2 Information Sy | 


System Action: The CICS attachment facility is terminated. 
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DSNCO26I DSNCSTOP FAILED TO DISABLE THE name RMI 


EXIT 


Explanation: The CICS attachment facility failed to disable the 
named resource manager interface (RMI) exit. Either the exit 
was in use at the time DSNCSTOFP tried to disable it, or an 
abend occurred in the RMI exit code while the 'in use' flag was 
on. The CICS system must be stopped and restarted before the 
CICS attachment facility can be restarted. 


| internal DB2 Information ta ~ | 
This message is issued by the following CSECT(s): DSNCSTOP 


ee Teens End of Internal DB2 Information eee | 


System Action: The CICS attachment facility continues the ter- 
mination processing after dumping the CICS trace, the resource 
control table (RCT), and the connection control table (CCT). 


Operator Response: Notify the attachment facility system pro- 
grammer. CICS must be stopped and restarted before 
restarting the CICS attachment facility. 


System Programmer Response: This could be a problem in the 
CICS 'task-related user exit'. The trace and any dumps associ- 
ated with this execution must be analyzed to determine the 
source of the error. 


SHUTDOWN IS IN PROGRESS. transaction COM- 
MANDS MAY NOT BE ENTERED 


DSNC027! 


Explanation: The CICS attachment facility does not accept 
commands directed to DB2 during or following the termination 
of the CICS attachment facility. 


| Internal DB2 Information avy | 
This message is issued by the following CSECT(s): DSNCCOM1 


a End of Internal DB2 Information Set 


System Action: The command is rejected. 


User Response: Notify the attachment facility system pro- 
grammer. 


DSNCO028I USER IS NOT AUTHORIZED FOR transaction COM- 


MANDS 


Explanation: DB2 has rejected the command request during 
the sign-on of the user. Therefore, the user is assumed to be 
unauthorized for the requested function in the command. 


fe ee Internal DB2 Information ~~ || 
This message is issued by the following CSECT(s): DSNCCOM1 


tae Sa eed End of Internal DB2 Information sd 


System Action: The command is rejected. 


Operator Response: Notify the attachment facility system pro- 
grammer. 


System Programmer Response: The authorization ID used is 
described in the generation procedures of the resource control 
table (RCT). If the user(s) should be allowed access to the 


command, they must be added to the list of users authorized for 
the command. 


DSNC0291 transaction COMMAND FAILED 


Explanation: The DB2 command specified in the message (as 
'transaction') failed to return a response message indicating 
the action taken by the command. 


| Internal DB2 Information " | 
This message is issued by the following CSECT(s): DSNCCOM1 


[eee End of Internal DB2 Information oe el 


System Action: The resulting action of the command is 
unknown. 


Operator Response: Notify the attachment facility system pro- 
grammer. 


System Programmer Response: Check the master console for 
any messages indicating why the command failed. 


DSNCOSOE AN ERROR HAS OCCURRED WRITING TO THE 
TRANSIENT DATA OUTPUT DESTINATION destina- 
tion 


Explanation: The CICS attachment facility encountered an 
error while writing to the indicated destination. 


é = ~~ Internal DB2 Information a aa 
This message is issued by the following CSECT(s): DSNCMSGO 


bia ee aes End of Internal DB2 Information eet ed 


System Action: The CICS attachment facility continues opera- 
tion. 


Operator Response: Notify the system programmer and, if the 
destination is one of the resource control table error destina- 
tions, use the CICS attachment facility MODIFY command to 
change the destination code to another destination if one is 
available. 


System Programmer Response: Follow CICS procedures to 
correct the error. Refer to CICS/OS/VS Messages and Codes 
CICS/OS/VS Problem Determination Guide for additional infor- 
mation. 


DSNCO311 THE COMMAND IS INVALID. THE ATTACHMENT 


FACILITY IS INACTIVE 


Explanation: STRT is the only valid command when the CICS 
attachment facility is inactive. Any other commands to the CICS 
attachment facility are not accepted when it is inactive. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCCOM1 


Hee code ee eee End of Internal DB2 Information pide! Bees 


System Action: The command is rejected. 


DSNC029!1 — DSNCO034I 


DSNC032I_~—s transaction COMMAND ALTERNATE DESTINA- 


TION OUTPUT COMPLETE 


Explanation: This response indicates that the DB2 command 
specified in the message (as 'transaction') is complete, and 
that the resulting output should be available at the requested 
device. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCCOM1 


Ue End of Internal DB2 Information | 


System Action: Processing continues normally. 


DSNC0331 TERMINAL ID IS NOT SUPPORTED BY BMS OR IS 


INVALID 


Explanation: This message is in response to a CICS attach- 
ment facility or DB2 command that requested an alternate desti- 
nation for the response. CICS basic mapping support (BMS) 
encountered an error while routing to the requested destina- 
tion. 


| Internal DB2 Information coo ee 
This message is issued by the following CSECT(s): DSNCMSGO 


eee eae End of internal DB2 information eee | 


System Action: The command is rejected. 


Operator Response: Ensure that the terminal 1D was correctly 
entered. Otherwise, notify the system programmer. _ 


System Programmer Response: Verify that the terminal ID is . 
valid. This message may occur if the destination device is not 
supported by BMS or if it does not exist in the CICS terminal 
control table. 


DSNC0341 INDOUBT RESOLUTION FOR ur-id IS INCORRECT 


Explanation: CICS indicates recovery is required for the 
‘ur-id', but the unit of recovery is not indoubt to DB2. If this 
message is issued, the error is serious. 


| Internal DB2 information ~~ ea 
This message is issued by the following CSECT(s): DSNCEXT1 


ee eee Ste End of Internal DB2 information Sih ee Ss cll 


System Action: The CICS attachment facility continues the 
startup process normally. 


Operator Response: Notify the CICS system programmer. 


System Programmer Response: CICS has tried to recover a 
unit of work by an identifier that was not in the resolution 
request list from DB2. Use the DISPLAY THREADS and 
RECOVER INDOUBT commands provided by DB2 to ensure that 
all indoubt units of work are resolved. 
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DSNC035I — DSNCO041I 


DSNC035I INDOUBT RESOLUTION FOR ur-id IS INCOM- 


PLETE 


Explanation: CICS indicates recovery should not be required 
for the 'ur-id', but DB2 is indoubt. If this message is issued, 
the error is serious. 


ici as internal DB2 Information i | 
This message is issued by the following CSECT(s): DSNCEXT1 


{| Ss End of Internal DB2 Information eel 


System Action: The CICS attachment facility continues the 
startup process normally. 


Operator Response: Notify the CICS system programmer. 


System Programmer Response: CICS cannot recover a unit of 
work by an identifier that was in the resolution request list from 
DB2. Use the DISPLAY THREAD and RECOVER INDOUBT com- 
mands provided by DB2 to ensure that all indoubt units of work 
are resolved. 


DSNCO36i INDOUBT RESOLUTION FOR ur-id IS INCON- 


SISTENT 


Explanation: CICS indicates recovery resolution for the ‘ur-id' 
should be ABORT (backout), but DB2 indicates the resolution 
should be COMMIT. If this message is issued, the error is 
serious. . 


i Internal DB2 Information ee ee 
This message is issued by the following CSECT(s): DSNCEXT1 


[daeste, wee eee End of Internal DB2 Information ee, 


System Action: The unit of work has been committed by DB2. 
The CICS attachment facility continues the startup process 
normally. 


Operator Response: Notify the CICS system programmer. 


System Programmer Response: CICS and/or DB2 restart proc- 
esses are not in synchronization, and the cause of the error 
must be identified. Appropriate action should be taken to 
return all resources to a consistent state. This error could have 
been caused by a damaged CICS system journal file. 


DSNC037A = subsystem [IS NOT ACTIVE command IS WAITING 


Explanation: The CICS attachment facility start (as 
‘command ') transaction is waiting for notification from the DB2 
subsystem specified in the message (as 'subsystem') that it 
has become active. The start of the CICS attachment facility 
complete after DB2 has started. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNCSTRT 


Senet oe End of internal DB2 Information Pd 


System Action: The CICS attachment facility waits to complete 
the start process. 
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Operator Response: Start the DB2 subsystem. 


DSNCO38i THE COMMAND IS INVALID WHILE WAITING FOR 


subsystem name 


Explanation: The command entered cannot be processed 
while the CICS attachment facility is waiting for the DB2 sub- 
system to start. 'Subsystem name' identifies the name of the 
DB2 subsystem that is not yet operational. 


See a: internal DB2 Information ~~~ | 
This message is issued by the following CSECT(s): DSNCCOM1 


ete ee os End of Internal DB2 information ees | 


System Action: The command is rejected. 


DSNCO391 THE ERROR DESTINATIONS ARE: 


d1 d2 d3 


Explanation: This message is in response to the MODIFY DES- 
TINATION command that lists the currently active message des- 
tinations known to the CICS attachment facility. Null entries 
show as '****' and can be modified so that they identify actual 
destinations. 


| Internal DB2 Information 5 | 
This message is issued by the following CSECT(s): DSNCCOM1 


{snd of Internal DB2 Information ______——_—d 


DSNC0401 PROGRAM REQUEST HANDLER MODULE name 


COULD NOT BE FOUND 


Explanation: During the CICS attachment facility initialization, 
an attempt was made to locate and load the named application 
program request handler, but it was not found in any of the 
libraries accessible to MVS through the MVS LOAD macro. 


— §Internal DB2 Information ~~ i 
This message is issued by the following CSECT(s): DSNCSTRT 


{Lo End of internal DB2 information Se hn 2 


System Action: The CICS attachment facility initialization is ter- 
minated. 


Operator Response: Notify the attachment facility system pro- 
grammer. 


System Programmer Response: An MVS load attempt was 
made to load the DB2 program request handler, but it was not 
found in the libraries accessible to MVS. Check the CICS 
JOBLIB/STEPLIB libraries, and ensure that DB2 libraries are 
made available. 


DSNCO041I NO ACTIVE THREADS 


Explanation: A DISPLAY command was entered, and there 
were no active threads created. The CICS attachment facility 
may have identified and signed on the attached subtasks, but a 
create thread had not been issued for any of the subtasks. 


| Internal DB2 Information ae | 
This message is issued by the following CSECT(s): DSNCCOM1 


[eee es End of Internal DB2 Information | 


DSNC0421 CONNECTION NOT AUTHORIZED TO name 


Explanation: The attempt to connect to the named DB2 sub- 
system failed, because the user was not authorized to access 
DB2. 


| Internal DB2 Information ce pe “| 
This message is issued by the following CSECT(s): DSNCSTRT 


tee eke End of Internal DB2 Information ee ee 


System Action: The CICS attachment facility terminates. 
Operator Response: Notify the system programmer. 


System Programmer Response: The user specified on the 
CICS job has not been authorized to connect to the named DB2 
subsystem. Refer to Section 4 (Volume 2) of Administration 
Guide for information on how to authorize a user to access DB2. 


DSNC0431 DSNCSTOP ENCOUNTERED ERROR, RECOVERY 


ROUTINE started/completed 


Explanation: A CICS abend occurred while disconnecting the 
CICS attachment facility from DB2 and deleting it from storage. 
This message may be issued twice. It is issued at the start of 
the abend recovery routine, which is indicated by 'started' in 
the message text. If the recovery routine is successful, the 
message is issued with 'completed' in the message text. 


| <== Internal DB2 Information 
This message is issued by the following CSECT(s): DSNCSTOP 


| Ena of Internal DB2 Information 


System Action: !f the recovery routine is not successful, the 
CICS attachment facility stop transaction terminates with a CICS 
transaction dump. If the recovery routine is successful, the 
CICS attachment facility is terminated normally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Any abend dumps associated 
with this message must be analyzed to determine the cause of 
the failure. 


DSNC0441 DSNCRCT ENTRY HAS BEEN CORRUPTED OR 


OVERLAID 


Explanation: The CICS attachment facility has detected that a 
resource control table (RCT) entry has been corrupted or over- 
laid since the CICS attachment facility was last started. 


| 
| 


DSNC042! — DSNC0471 


iy internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNCEXT1 


es End of Internal DB2 Information bie teed 


System Action: The CICS task is abended with a reason code 
of 00C30011. No other action is taken by the CICS attachment 
facility. 


Operator Response: Notify the system programmer. 


System Programmer Response: The abend dumps associated 
with this message must be analyzed to determine which CICS 
transaction and RCT entry has been corrupted. Restart the 
CICS attachment facility to obtain a valid copy of the RCT. 


DSNCO45i RESOURCE MANAGER rmi-name IS UNKNOWN 


TO CICS ATTACH FACILITY 


Explanation: The CICS attachment facility received a request 
from a resource manager interface (RMI) named 'rmi-name'. 
This RMI is not known by the CICS attachment facility. 


[fea oe, Internal DB2 Information <a  —l 
This message is issued by the following CSECT(s): DSNCEXT1 


Tet teosion tes End of Internal DB2 Information Seems = ol 


System Action: The CICS task is abended with a CICS trans- 
action dump. 


Operator Response: Notify the system programmer. 


System Programmer Response: The CICS transaction dump 
should be analyzed to determine the source of the unknown 
resource manager interface (RMI) request. CICS dump infor- 
mation, such as the trace table and program storage, can aid in 
determining which module issued the request. The CICS EXEC 
Interface Biock resource name field, EIBRSRCE, contains the 
name of the RMI. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


DSNCO46i RCT RELEASE LEVEL nnnn IS INCONSISTENT 


WITH CICS ATTACH RELEASE LEVEL mmmm 


Explanation: The resource control table (RCT) release level 
‘nnnn' does not match the CICS attachment facility release 
level ‘mmmm'. 


—a ia Internal DB2 Information fee el 
This message is issued by the following CSECT(s): DSNCSTRT 


| End of Internal DB2 Information ___———_—d 


Operator Response: Notify the system programmer. 


System Programmer Response: Reassemble the RCT using 
the correct DB2 release level 'mmmm' DSNCRCT macro. 


DSNC047i =TWA SIZE IS TOO SMALL FOR TRANSID tran 


Explanation: The CICS TWASIZE defined for transaction 'tran' 
is too small to support the CICS attachment facility command 
processor program (DSNCCOM1). 
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DSNC700!I — DSNC700! 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNCEXT1 


rae End of Internal DB2 Information oe ee | 


System Action: The CICS attachment facility abends this CICS 
task with a CICS transaction abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Redefine the command 
processor transaction to specify the correct TWASIZE. Refer to 


3-22 DB2 Messages and Codes 


Section 5 (Volume 2) of Administration Guide for information 
regarding the required value. 


DSNC700! DSNCSAMG message-id HAS BEEN ISSUED 


Explanation: This message is issued only if the requested 
message could not be found in the message directory 
(DSNCMSGT). 


System Action: The system proceeds as though the requested 
message had been issued. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to this manual for actual 
message text. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for failure analysis procedures. 


DSNET201 — DSNEOO8I 





TSO Attachment Facility Messages (DSNE...) 


In the TSO attachment facility, the user can control 
whether message IDs are displayed. To see them, 
type PROFILE MSGID. To suppress them, type 
PROFILE NOMSGID. 


Trace messages associated with the TSO attach- 
ment facility (including DSN and DB2!) are not 
listed in this manual. They are in Section 8 of 
Diagnosis Guide and Reference, which also 
explains how to turn on the TSO attachment facility 
tracing facilities. How to take TSO dumps is 
explained in Section 5 of Diagnosis Guide and Ref- 
erence. 


All DSN command processor trace messages have 
the same message number: DSNET20I. 


DSNET20I 


Explanation: This is one of many possible trace messages 
bearing this message number. Complete documentation of all 
of the TSO attachment facility trace messages bearing this 
message number is found in Section 8 of Diagnosis Guide and 
Reference. 


DSNE004E PROBABLE SUBSYSTEM ERROR DETECTED IN 
CSECT csect-name, SUBSYSTEM FUNCTION 
service, RETCODE retcode, REASON CODE 
reason-code 


Explanation: A subsystem error has occurred. The function 
identified in the message as 'service' is either an MVS or a 
DB2 service routine. The error was discovered in the 
‘csect-name' indicated in the message. Refer to the appro- 
priate MVS publications for a description of the return and 
reason codes. 


—=.. Internal DB2 Information Soe al 


This message is issued by the following CSECT(s): 


DSNECPO0O0 DSNECP10 DSNECP12 
DSNECP13 DSNECP14 DSNECP16 
DSNECP17 DSNECP18 DSNECP19 
DSNECP20 DSNECP22 DSNECP23 
DSNECP24 DSNECP25 DSNECP26 
DSNECP29 DSNECP30 DSNECP31 
DSNECP40 DSNECP41 DSNECP42 
DSNECP60 DSNECP61 DSNECP62 
DSNECP66 DSNECP67 DSNECP68 
DSNECP69 


ee ae End of Internal DB2 Information eee 


System Action: This message is sometimes followed by an 
intentional system abend. !n other instances, the DSN 
command processor will terminate the current subcommand 
and attempt to continue by issuing another DSN prompt. 


User Response: Run the job again with a SYSUDUMP dump 
data set allocated and DSN tracing set to 123. Collect the DSN 
trace stream. If an abend occurs, collect the dump. 


DSNEO005A EXECUTION IS INTERRUPTED. ENTER C TO 
CANCEL, OR ANY OTHER REPLY TO RESUME 
THE subcmd SUBCOMMAND 


Explanation: The Attention key was pressed. Entering a 'C' 
will cancel the DSN subcomman4d that is currently executing. If 
the user enters a question mark, message DSNEOO6A will 
appear. Any other reply will cause execution of the subcom- 
mand that was in progress to continue. 


If the DSN prompt was issued just before the Attention key was 
pressed, 'subcmd' may be either 'DSN' or the previously 
invoked subcommand. 


| : ~ Internal DB2 Information eH 
This message is issued by the following CSECT(s): DSNECPO01 


eee End of Internal DB2 Information ee 


User Response: Enter a 'C' to cancel the DB2 subcommand 
currently executing. The DSN prompt will appear on the ter- 
minal. Enter anything else (except another attention) to resume 
execution. 


DSNEOO6A C WILL TERMINATE THE SUBCOMMAND WITH 
UNCOMMITTED CHANGES BACKED OUT © 


Explanation: Enter a 'C' to terminate the subcommand. No’ 
uncommitted changes are made to the database. Any other 
reply causes subcommand execution to continue. 


| Internal DB2 Information eg ee | 
This message is issued by the following CSECT(s): DSNECPO1 


ae End of internal DB2 Information ee ee eel 


User Response: Enter a 'C' to terminate the subcommand. 
Control returns to DSN, and the DSN prompt appears on the ter- 
minal. This is a second-level help message associated with 
message DSNEOOSA. 


DSNE008i REPLY WAS xxxxx, EXECUTION RESUMED 


Explanation: Execution was suspended by a user ATTENTION 
and then was resumed, because the string specified in the 
message as 'xxxxx' was entered. 


ae Internal DB2 Information ete = 
This message is issued by the following CSECT(s): DSNECP01 


Veen eee End of Interna! DB2 Information _ 


System Action: Control returns to the interrupted session. 
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DSNEO09I — DSNE103E 


DSNEO0SI REPLY WAS C, EXECUTION TERMINATED 


Explanation: The response to message DSNEOOSA was a C. 
This caused the current subcommand to terminate. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNECPO1 
a End of Internal DB2 Information papel 


System Action: The current subcommand is terminated. The 
DSN prompt appears on the terminal. 


User Response: You can now enter another DSN subcom- 
mand. 


SUBCOMMAND subcmd CANCELED BY ATTEN- 
TION 


DSNEO101I 


Explanation: The subcommand specified in the messages was 
canceled because the user pressed the attention key and then 
entered a 'C'. 


(2 Internal DB2 Information eee Opa 
This message is issued by the following CSECT(s): DSNECP0O1 


eae End of Internal DB2 Information ey | 


System Action: The current subcommand is terminated. The 
DSN prompt appears on the terminal. 


User Response: A new subcommand can be entered. 


DSNE0111 DSN COMMAND CANCELED BY ATTENTION 


Explanation: The user of the DSN command processor has 
pressed attention. Since this occurred before DSN was fully ini- 
tialized, DSN terminates. If DSN had been fully initialized, it 
would have prompted the user to continue or cancel. 


a ~~ _ Internal DB2 Information ian 
This message is issued by the following CSECT(s): DSNECP01 


[Ena of internal DB2 Information sd 


System Action: The DSN command processor terminates. 
Control returns to TSO or the calling CLIST. 


User Response: Restart DSN. 


DSNE1001 ssid NOT OPERATIONAL, RETRY COUNT IS ZERO 


Explanation: The subsystem (specified in the message as 
‘ssid') was not active, and no retries remain to be executed. 
No more connection attempts are made. The operator should 
be notified to start this specific subsystem, and the DSN 
command should be resubmitted. Issue the DSN command with 
the RETRY parameter set greater than zero. 
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Internal DB2 Information : ars 
This message is issued by the following CSECT(s): DSNECP12 


[Pesce a Loe End of Internal DB2 Information Bane ee 


System Action: Control returns to TSO. 
User Response: Notify the operator to start the subsystem. 


Operator Response: Start the subsystem with the 'ssid' speci- 
fied in the message. 


DSNE1011 ssid NOT OPERATIONAL, WILL RETRY nnn MORE 


TIMES 


Explanation: The requested DB2 subsystem ‘ssid' was not 
started or is not available. Connection to it will be attempted 
'nnn' more times. This message is issued every 30 seconds 
(and each time 'nnn' is decreased by 1) until the connection is 
made or 'nnn' is zero. 


| internal DB2 Information a i 
This message is issued by the following CSECT(s): DSNECP12 


[ks Sogesee Sg End of Internal DB2 tnformation nae seal 


System Action: DSN repeats the connection attempt until the 
connection is made or until the retry count is decreased to 
zero. 


User Response: Notify the operator start DB2. 


DSNE1021 YOU ARE NOT AUTHORIZED TO USE DB2 SUB- 


SYSTEM ssid 


Explanation: The authorization ID is not authorized to use sub- 
system 'ssid'. 


| internal DB2 Information Sareea | 
This message is issued by the following CSECT(s): DSNECP12 


A Anette End of Internal DB2 Information pati emer 


System Action: Control returns to TSO. 


User Response: Contact the system programmer, or system 
administrator to arrange for the required RACF or equivalent 
security system authorization. 


DSNE103E MAIN STORAGE REQUEST FROM csect-id FAILED 


Explanation: A request for main storage failed. 


i= Internal DB2 Information ~~ —<—-t 


This message is issued by the following CSECT(s): DSNECP29, 
DSNECP41, DSNECP42, DSNECP66 


ae, End of Internal DB2 Information Sa eee nets 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Increase the address space size. This can be 
done as part of the logging on process. 


DSNE104E RETRY COUNT OF number NOT VALID, SET TO 


120 


Explanation: An invalid 'RETRY' parameter was entered on 
the DSN command. It has been set to 120. Valid retry counts 
are integer numbers from 0 to 120. 


| = : Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP12 


esmepacceees oe End of Internal DB2 Information oe 


System Action: Retry count is modified, and DSN execution 
continues. 


User Response: The next time you invoke DSN, use a RETRY 
count of 0 to 120. 


DSNE105E . SUBSYSTEM ssid NO LONGER OPERATIONAL 


Explanation: The DB2 subsystem is down. !t must be restarted 
before the user can continue. 


[ ee Internal DB2 Information 


This message is issued by the following CSECT(s): DSNECP13, 
DSNECP66 


eee Poh End of interna! DB2 Information So | 


System Action: Control returns to TSO attachment facility. 


User Response: Before you can continue, DB2 must be 
restarted. You must also reissue the DSN command. ISPF 
users should restart their jobs. 


DSNE106E PLAN plan-id NOT AUTHORIZED FOR SUB- 


SYSTEM ssid AND AUTH-ID auth-id 


Explanation: The requested combination of plan-id, 
subsystem-id, and user-id is not currently authorized. 


| Internal DB2 Information 7a 
This message is issued by the following CSECT(s): DSNECP13 


| End of Internal DB2 Information ____——_| 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Notify the system programmer or system 
administrator to obtain proper authorization. 


System Programmer Response: The system administrator for 
the DB2 subsystem can arrange the necessary authorization. 


DSNE107E SUBSYSTEM RESOURCE NEEDED FOR PLAN 
plan-name, AUTH ID auth-id, AND SUBSYSTEM 
subsys IS NOT AVAILABLE 


Explanation: The DB2 subsystem was unable to allocate a nec- 
essary resource for the requested combination of plan-id, 
user-id, and subsystem-id. This message is accompanied by 
DSNE108E. An attempt to establish connection with the DB2 
subsystem has failed. 


DSNE104E — DSNE109E 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP13 


Mes End of internal DB2 Information freee at 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Arrange to obtain the needed resource, and 
resubmit the subcommand. See the explanation for message 
DSNE108E, which accompanies this message. 


DSNE108E FEEDBACK - REASON CODE reason-code TYPE = 
type RESOURCE NAME - 44 characters 


Explanation: This message accompanies message DSNE107E 
or DSNE114E to explain the problem more clearly. RESOURCE 
NAME is the name of the unavailable resource. The reason 
code is in hexadecimal format. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP13 


Us ee End of Internal DB2 Information ee 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Arrange for the missing resource to be avail- 
able, and resubmit your job. 


Problem Determination: The reason the resource is unavail- 
able is identified by a reason code. The reason codes that 
appear in this message are described in “Section 4. DB2 
Codes” on page 4-1. 


TYPE and RESOURCE NAME identify the resource that is cur- 
rently unavailable. The TYPE code identifies the type, as well 
as the format and content, of the RESOURCE NAME. Refer to 
Figure 4in Appendix B, “Problem Determination” on page X-5 
for an explanation of resource type codes. 


DSNE109E NO INPUT TO BIND, SUBCOMMAND TERMINATED 


Explanation: No LIBRARY parameter was specified on the 
BIND subcommand. No DBRMLIB was allocated. 


| ; Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP29 


ae seat End of Internal DB2 Information Sateen | 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Specify the LIBRARY parameter, and resubmit 
the BIND subcommand. Alternatively, you could issue an 
ALLOCATE command for the DDNAME DBRMLIB and then 
resubmit the BIND subcommand as originally written. 
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DSNE110E — DSNE118E 


DSNE110E ssid NOT VALID SUBSYSTEM ID, COMMAND TER- 


MINATED 


Explanation: There is no subsystem id with the name identified 
in the message as 'ssid'. The subsystem identifier you specify 
(or default to) on the DSN command must exist. This message 
is the result of you specifying (or defaulting to) a non-existent 
subsystem identifier. For information on the SYSTEM param- 
eter of the DSN command, refer to Chapter 2 of Command and 
Utility Reference under DSN. 


| internal DB2 information 
This message is issued by the following CSECT(s): DSNECP12 
— End of Internal DB2 Information nn 
System Action: The DSN processor ends, and control returns 


to TSO. 


User Response: Reissue the command with a valid 'SYSTEM' 
parameter. 


DSNE111E INSTALLATION EXIT REJECTED DSNAME data- 


set-name 


Explanation: A local installation-supplied exit has rejected the 
data set name identified in the message as 'data-set-name'. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNECP23, 
DSNECP29, DSNECP69 


[te eek ae End of Internal DB2 Information aes 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Either correct the data set name specified, or 
arrange to authorize the original data set name. Resubmit the 
request. 


DSNE112E userid STILL SIGNED ON TO SUBSYSTEM ssid 


Explanation: An attempt was made to sign on to DB2 when the 
user was already signed on. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP12 


lice ee eee End of internal DB2 Information Seen 


System Action: Control returns to TSO. 


User Response: Log off and log on again. 


DSNE113E NOT ABLE TO LINK TO MODULE modname IN 
DSNAME data-set-name 


Explanation: A DB2 subsystem error occurred during an 
attempt to link to module 'modname' in data set 
‘data-set-name'. 
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Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNECP16 


Pei Sees End of Internal DB2 Information pons Be 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Check that the module exists and that its 
name is spelled correctly. Enter the correct module name. 


DSNE114E THE COMBINATION OF PLAN planid, AUTH ID 
auth-id, AND SUBSYSTEM ssid IS NOT VALID 


Explanation: The resource in message DSNE108E, which will 
follow this message, is not a valid resource name. 


| ~ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP13 


ee noe End of Internal DB2 Information an es | 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Correct the invalid combination, and resubmit 
the subcommand. The problem is probably caused by a user 
spelling error. If it is not, check with the system administrator 
to determine the availability of the needed resource. Your 
program may need to be bound. See the explanation for 
message DSNE108 (which accompanies this one) for more 
information. 


DSNE117E NOT ABLE TO LOCATE membername IN DSNAME 
data-set-name 


Explanation: The ‘data-set-name' specified does not contain 
the member the user wanted to run. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP16 


ee End of Interna! DB2 Information ee 


System Action: Control remains with the DSN command 
processor, and the DSN prompt appears on the terminal. The 
DSN command processor is ready for another command. 


User Response: Correct the PROGRAM or LIBRARY param- 
eter, and resubmit the subcommand. 


DSNE118E_ _—invalid-command NOT VALID COMMAND 


Explanation: The user entered an invalid command. A typing 
error may be responsible. You may be trying to runa 
command processor that is either not available on your system 
or that is not part of your current LNKLST or STEPLIB concat- 
enation. 


ae an Internal DB2 Information ee a | 
This message is issued by the following CSECT(s): DSNECP31 


a End of Internal DB2 Information ae 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Either correct the spelling error, or rearrange 
your library concatenation so that you can access the required 
command processor. Resubmit the command. 


DSNE119E data-set-name NOT PARTITIONED DATA SET 


Explanation: The user tried to allocate a sequential data set 
when a partitioned data set was required. 


= = oe internal DB2 Information 


This message is issued by the following CSECT(s): DSNECP23, 
DSNECP29, DSNECP69 


ea eee a End of Internal DB2 Information 28 eee 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Check the data-set-name. The data set you 
specified is sequential, but you specified a member name. 
Remove the member name, and resubmit the job. 


DSNE120E  data-set-name NOT SEQUENTIAL DATA SET 


Explanation: The user tried to allocate a partitioned data set 
when a sequential data set was required. 


| Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNECP69 


berets eee End of internal DB2 Information ee od 


System Action: The TSO attachment facility is ready for more 
input, 


User Response: Check the data-set-name. The data set you 
specified is partitioned, but you did not specify a member 
name. Add a member name, and resubmit the job. 


DSNE121E 


Explanation: The DB2 subsystem was unable to open the 
requested data set. 


csect-id NOT ABLE TO OPEN DATA SET 


[P= is Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): DSNECP23, 
DSNECP69 


ee End of Internal DB2 Information Feet | 


System Action: The TSO attachment facility is ready for more 
input. 


DSNE119E — DSNE125E 


User Response: For information about why the data set could 
not be opened, read the explanations of the messages that 
accompany this message. Correct the condition, and resubmit 
the job. 


DSNE122E DATA SET ORGANIZATION MUST BE EITHER 


SEQUENTIAL OR PARTITIONED. data-set-name IS 
NOT 


Explanation: The DB2 subsystem was unable to open data set 
‘data-set-name', because it is not a sequential or partitioned 
data set. 


[ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP69 


(eee = End of Internal DB2 information ee 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Correct the data-set-name, or change the data 
set organization. Resubmit the job. 


DSNE123i data-set-name NOT PARTITIONED DATA SET, IT!S 


IGNORED 


Explanation: The data-set-named in the message is required 
to be partitioned. It is not and, consequently, was ignored. 


eS Internal DB2 Information —— el 
This message is issued by the following CSECT(s): DSNECP29 


ee End of Internal DB2 Information ae ees 


System Action: DSN will attempt to continue BIND processing. 


User Response: Correct the subcommand, and resubmit it. 


DSNE124E DATA SET data-set-name, MEMBER member- 


name IN USE, TRY LATER 


Explanation: The member contained in 'data-set-name' is cur- 
rently in use. This message is normally issued when another 
user is updating the specified member. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP69 


Lede Teh es End of Internal DB2 Information Spa 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Wait until the member is available and 
reissue your DCLGEN request. 


DSNE125E DATA SET data-set-name IN USE, TRY LATER 


Explanation: The sequential data set 'data-set-name' is cur- 
rently in use. This message is normally issued when another 
user is updating the specified data set. 
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DSNE126E — DSNE132I 


| internal DB2 Information 7 
This message is issued by the following CSECT(s): DSNECP69 


eee End of Internal DB2 Information oo et 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Wait until the data set is available and reissue 
your DCLGEN request. 


DSNE126E THE DB2 OPERATOR IS STOPPING THE SUB- 


SYSTEM. PLEASE END YOUR DSN SESSION 


Explanation: The operator has requested that DB2 quiesce. 
The user should promptly finish the current task and terminate 
the DSN session so that this can take place. This message may 
be followed by message DSNE1271. 


he ee a Internal DB2 information | 
This message is issued by the following CSECT(s): DSNECPOO 


[eo ae oe End of Interna! DB2 Information eee ee Saat 


System Action: No new users will be permitted to initiate DB2 
sessions. Current users will be permitted to work until they ter- 
minate their connections to DB2. 


User Response: End your DSN session as soon as possible. 


DSNE1271 THE DB2 OPERATOR IS STOPPING THE SUB- 


SYSTEM. DSN IS TERMINATING 


Explanation: The operator has requested that DB2 terminate. 


[ — Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECPOO 


ee ae End of Internal DB2 Information or 


System Action: DB2 will shut down, interrupting user activities 
as necessary. DSN will terminate immediately and return the 
user to TSO. 


User Response: Reinitiate your session when DB2 returns. 


DSNE128I DB2 IS ABNORMALLY ENDING. DSN IS TERMI- 


NATING 


Explanation: DB2 has encountered a problem from which it 
cannot recover. 


rss oe = Internal DB2 Information =. 
This message is issued by the following CSECT(s): DSNECPOO 


[tera Sm End of Internal DB2 Information oe teas: Al 


System Action: DB2 is abending. DSN terminates immediately 
and returns the user to TSO. 


User Response: Reinitiate your session when DB2 returns. 
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DSNE1301 MAXIMUM NUMBER OF DB2 USERS REACHED. 


YOUR RETRY COUNT IS ZERO 


Explanation: The number of concurrent connections to DB2 is 
restricted. The number is specified in the installation parame- 
ters in member DSN6SYSP. For TSO foreground, see param- 
eter IDFORE. For background jobs, see parameter IDBACK. 
The DSN request has been denied, because the current number 
of DB2 connections in the system has reached the installation- 
specified limit. 


| Internal DB2 Information en 
This message is issued by the following CSECT(s): DSNECP12 


— End of Internal DB2 Information ee 


System Action: Control returns to TSO. 


User Response: Resubmit the DSN command when activity 
using DB2 has diminished. If still unsuccessful, see the system 
programmer about the installation parameters. 


DSNE1311 MAXIMUM NUMBER OF DB2 USERS REACHED. 


WILL RETRY nnn MORE TIMES 


Explanation: The number of concurrent connections to DB2 is 
restricted. The number is specified in the installation parame- 
ters in member DSN6SYSP. For TSO foreground, see param- 
eter IDFORE. For background jobs, see parameter IDBACK. 
The DSN request has been denied, because the current number 
of DB2 connections in the system has reached the installation 
specified limit. 


The DSN connection to DB2 will be attempted 'nnn' more 
times. This message is issued every 30 seconds (and each 
time 'nnn' is decreased by 1) until the connection is made or 
until 'nnn' is decreased to zero. 


| Internal DB2 Information ee Pa ie | 
This message is issued by the following CSECT(s): DSNECP12 


ee ae End of Internal DB2 Information eee 


System Action: DSN repeats the connection attempt until the 
connection is made or the retry count is decreased to 0. 


User Response: [If all retry attempts fail, resubmit the DSN 
command when activity using DB2 has diminished. If still 
unsuccessful, see the system programmer about the installa- 
tion parameters. 


DSNE1321 DB2!S OPERATING IN RESTRICTED ACCESS 


MODE. MAINTENANCE PERSONNEL ONLY 


Explanation: DB2 is not available for normal operation. It is 
only available to service personnel. 


| Internal DB2 information vy | 
This message is issued by the following CSECT(s): DSNECP12. 


[sae toe ae End of Internal DB2 Information _ 


System Action: Control returns to the caller. Your request was 
not processed. The DSN command processor was unable to 
connect to DB2. 


User Response: Wait until DB2 is available for general use, 
then resubmit your request. 


DSNE133E RELEASE LEVEL MISMATCH - DB2 IS db2level, 


DSN 1S dsnlevel. DSN WILL TERMINATE 


Explanation: The DSN command processor, perhaps running 
under the control of DB2l, has detected a release level mis- 
match between itself and DB2. The DB2 toad modules are 
release level '‘db2level'. The DSN command processor load 
modules are release level 'dsnlevel'. The levels are 
expressed as strings that are three characters long. The first 
character is the version number; the second is the release 
number; the third is the modification level number. Because 
these numbers are not the same, DB2 was installed incorrectly 
or you invoked the DSN command processor incorrectly. 


[re internal DB2 information a ad 
This message is issued by the following CSECT(s): DSNECP12 | 


[| snd of Internal DB2 Information | 


System Action: The DSN command processor terminates. 


User Response: Check that your method of invoking DSN or 

DB2I allocates the correct libraries for DSN. tf you used JCL or 

a log-on procedure to connect to the DSN code, check your 

JOBLIB and STEPLIB allocations. If you used a clist to run the 

DSN code, check that you obtain the right version of the DSN | 
code. See your system programmer if you invoke DSN using | 
procedures supplied by your system programmer. 


Operator Response: Notify the system programmer. 
System Programmer Response: See the user response. | 


Problem Determination: Determine the data set you access to 
invoke the DSN command processor and the data set that was 

used to start DB2. The data sets should be the same. If they 

are the same, the data set was improperly installed and must | 
be repaired. | 


DSNE230A TO REBIND A PLAN, YOU MUST ENTER THE 
NAME OF A PLAN 


Explanation: The user has attempted to use the REBIND panel 
without specifying a plan-name. 


[~ internal DB2 Information ~ ; | 
This message is issued by the following CSECT(s): DSNEBPO3 


ae ere End of Internal DB2 Information eee 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Fill in the plan-name, and try again. 


DSNE231A TO FREE A PLAN, YOU MUST ENTER THE NAME 
OF A PLAN 


Explanation: The user has attempted to use the FREE panel 
without specifying a plan-name. 


DSNE133E — DSNE291A 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNEBP0O4 


ee End of Internal DB2 Information eae ae al 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Fill in the plan-name, and try again. 


DSNE283A THE , (COMMA) OPTION IS INCOMPATIBLE WITH 
THE hostlang LANGUAGE 


Explanation: The user tried to select the ‘hostlang' APPLICA- 
TION LANGUAGE and the comma option of the DECIMAL POINT 
field on the DB2! defaults panel. This combination is not sup- 
ported. 


fe Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNEOPO1 


cr eee End of Internal DB2 Information nee 


System Action: The defaults panel is displayed again. 


User Response: Either change the APPLICATION LANGUAGE 
field or the DECIMAL POINT field. If you need the C (C/370 
Compiler), then the DECIMAL POINT field must contain a 
decimal point (.). 


DSNE288A YOU CANNOT SPECIFY (RUN) = YES WITH CICS 
OR IMS 


Explanation: Application programs that make CICS or IMS/VS 
calls cannot be run from the TSO environment. They can, 
however, be precompiled, bound, compiled, and linked under 
TSO. The user should specify N on the RUN panei when pre- 
paring a CICS or IMS/VS application. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNEPPO1 


—_—————a End of Internal DB2 Information bee 


System Action: The system is waiting for new input to the 
panel. 


User Response: Change the RUN option to N. 


DSNE291A ALL DB2 COMMANDS BEGIN WITH A DASH 


Explanation: The user omitted the DB2 command recognition 
character that must precede all DB2 commands. 


‘nas Internal DB2 Information ——— 
This message is issued by the following CSECT(s): DSNEKPO1 


Paha at End of Internal DB2 Information eed 


System Action: The DB2 commands panel is displayed again 
so the user can resubmit the command. 


User Response: Add the DB2 command recognition character, 
and reenter the command. 
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DSNE292!I — DSNE340I 


DSNE292i DATA SET data-set-name NOW CONTAINS YOUR 


JCL 


Explanation: DB2I has just created some JCL for you. The JCL 
now resides in data set 'data-set-name'. You can now edit this 
data, if desired. The TSO SUBMIT command will start the job 
running in background. 


[ ~~ Internal DB2 Information ~ ” | 


This message is issued by the following CSECT(s): DSNEUCO1, 
DSNEPC01, DSNETCO1 


(> Ae End of Internal DB2 Information oteret 


System Action: The system is waiting for your next request. 


User Response: You can start another DB2l job or leave the 
panel. 


DSNE293A MEMBER NAME IS REQUIRED. YOUR PROGRAM 
MUST BE IN A PDS 


Explanation: The user either has attempted to run a program 
that is not in a partitioned data set or has forgotten to specify a 
member name. 


= ~~ internal DB2 Information | 
This message is issued by the following CSECT(s): DSNERCO1 


ere End of Internal DB2 Information pear oe LY 


System Action: The RUN panel will be displayed so that the 
user can specify a member name and try the run again. 


User Response: Specify a member name, and rerun the 
program. 


DSNE2941 SYSTEM RETCODE=hex-code USER OR DSN 


RETCODE = decimal-code 


Explanation: A DB2i function has just completed. The return 
codes for that function are returned in this message. The vari- 
able 'hex-code' is a 3-digit hexadecimal number; the variable 
'decimal-code' is a 3-digit decimal number. Refer to the 
appropriate MVS publication for explanations of the return 
codes. 


| : Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNEBCO02 DSNEBCO3 DSNEBC04 
DSNEDCO1 DSNEKCO1 DSNERC01 
DSNEUCO1 


[ End of Internal DB2 Information re 


System Action: DB2l is ready for another execution cycle 
unless other messages appeared indicating that DB2 is unavail- 
able. 
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User Response: You may have to change input parameters to 
correct unsatisfactory completion codes. 


DSNE295A YOU CANNOT DISPLAY AND RESTART A UTILITY 
AT THE SAME TIME 


Explanation: You have set options on the DB2l Utilities panel 
that call for conflicting actions. You can either DISPLAY the 
status of a utility, or you can RESTART a utility, but you cannot 
do both. 


[ a ae Internal DB2 Information ~ = Sa | 
This message is issued by the following CSECT(s): DSNEUPO1 


Pie ace eex § End of internal DB2 Information ee 


System Action: The system is waiting for new input to the 
panel. 


User Response: Either change the RESTART option to NO, or 
select a different FUNCTION. 


DSNE296A YOU CANNOT TERMINATE AND RESTART A 
UTILITY AT THE SAME TIME 


Explanation: You have set conflicting options on the DB2! Utili- 
ties panel. You can either TERMINATE a utility, or you can 
RESTART a utility, but you cannot do both. 


es => Internal DB2 Information [ee ol 
This message is issued by the following CSECT(s): DSNEUPO1 


Le End of Internal DB2 Information _ 


System Action: The system is waiting for new input to the 
panel. 


User Response: Either change the RESTART option to NO, or 
select a different FUNCTION. 


DSNE3401 INTERNAL ERROR — ILLEGAL TYPE IN MODULE 


module-name 


Explanation: An internal DB2 problem has occurred. The 
named module has detected a nonexistent SQLTYPE. 


| = interna! DB2 Information a “| 


This message is issued by the following CSECT(s): DSNESM30, 
DSNESM32 


Lee End of Internal DB2 Information eateaiee hee 


User Response: Collect the SPUFI trace and ISPF log, and 
notify either the system programmer or the database adminis- 
trator. 


You may have to rerun the failing job after you have turned on 
trace. This will enable you to send trace messages to the ISPF 
log. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DSNE351A EDIT PROCESSING OPTION MUST BE Y (YES) OR 
N (NO) 


Explanation: The user specified an edit option other than 
'YES', 'NO', or the abbreviation 'Y' or 'N'. A valid user 
response determines whether SPUFI invokes the ISPF editor to 
allow the user to edit the input data set. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESPO1 


[eee End of Internal DB2 Information eee 


System Action: SPUFI will wait until the user enters a valid 
response. 


User Response: Type ina 'Y' or an 'N', and press 'ENTER'. 


DSNE352A EXECUTE PROCESSING OPTION MUST BE Y 
(YES) OR N (NO) 


Explanation: The user specified an execute option other than 
‘'YES', 'NO', or the abbreviation 'Y' or 'N'. A valid user 
response determines whether SPUFI executes the SQL state- 
ments in the user input data set. 


[oe ee Internal DB2 Information aaa | 
This message is issued by the following CSECT(s): DSNESPO1 


[erates End of Internal DB2 Information eta eee re etl 


System Action: SPUFI waits until the user enters a valid 
response. 


User Response: Type ina 'Y' or an ''N', and press 'ENTER'. 


DSNE353A BROWSE PROCESSING OPTION MUST BE Y (YES) 
OR N (NO) 


Explanation: The user specified a browse option other than 
'YES', 'NO', or the abbreviation 'Y' or 'N'. A valid user 
response determines whether SPUFI invokes ISPF BROWSE to 
allow the user to browse the output data set. 


a ~~~ Internal DB2 Information =. =e ~ | 
This message is issued by the following CSECT(s): DSNESP01 


be eee End of Interna! DB2 Information ee ee 


System Action: SPUFI will wait until the user enters a valid 
response. 


User Response: Type ina 'Y' or an 'N', and press 'ENTER'. 


DSNE354A AUTOCOMMIT PROCESSING OPTION MUST BE Y 
(YES) OR N (NO) 


Explanation: The user specified an AUTOCOMMIT option other 
than 'YES', 'NO', or the abbreviation 'Y' or 'N'. A valid user 
response determines whether SPUFI automatically commits all 
the changes to the database subsystem. This was encountered 
as a result of executing the user’s SQL statement(s). The 
commit is done at the end of the processing of an input data set, 
if it is requested and if there has been no SQL execution error. 


DSNE351A — DSNE360A 


| Internal DB2 Information = | 
This message is issued by the following CSECT(s): DSNESPO1 


| snd of internal DB2 Information =| 


System Action: SPUFI waits until the user enters a valid 
response. 


User Response: Type ina 'Y' or an ''N', and press 'ENTER'. 


DSNE355A CHANGE DEFAULTS PROCESSING OPTION MUST 
BE Y (YES) OR N (NO) 


Explanation: The user specified a change-defauit option other 
than 'YES', 'NO', or the abbreviation 'Y' or 'N'. A valid user 
response determines whether SPUFI displays the current- 
session SPUFI defaults and allows the user to change the 
defaults. 


| —— Internal DB2 Information ~~ er 
This message is issued by the following CSECT(s): DSNESPO1 


{oo End of internal DB2 Information lata 


System Action: SPUFI waits until the user enters a valid 
response. 


User Response: Type ina 'Y' or an 'N', and press 'ENTER'. 


DSNE3S9A OUTPUT DATA SET NAME REQUIRED FOR 
EXECUTE OR BROWSE 


Explanation: The user did not specify the name of the output 
data set. 


[ - —_ Interna! DB2 Information se = | 
This message is issued by the following CSECT(s): DSNESPO01 


[eye ee, End of Internal DB2 Information eee 


System Action: SPUFI waits until the user specifies an output 
data set. 


User Response: Type in the correct entry, and press 'ENTER'. 


DSNE360A THE OUTPUT DATA SET MUST RESIDE ON DASD 


Explanation: The user has attempted to send the output of 
SPUFI to a SYSOUT data set. You must enter a generic device 
class that contains only DASD devices. 


| Internal DB2 Information ~~ ey 
This message is issued by the following CSECT(s): DSNESPO1 


Peco es End of Internal DB2 Information gt 


System Action: SPUFI waits until the user specifies a valid 
output device class. 


User Response: Type in the correct entry, and press 'ENTER'. 
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DSNE363A — DSNE372A 


DSNE363A ONLY RR (REPEATABLE READ) OR CS (CURSOR 
STABILITY) ALLOWED 


Explanation: The user has entered an invalid isolation level. 
This value must be either RR or CS. ‘Isolation level' here 
refers to the degree to which the SPUFI user wants to isolate 
SQL execution from the effects of other concurrently executing 
DB2 applications. 


if the repeatable read (RR) level is specified and the 
AUTOCOMMIT option is 'YES', other applications can modify 
the selected database values as soon as the SPUF! EXECUTE 
phase is completed and as soon as the automatic COMMIT (or 
ROLLBACK, if an error was encountered,) operation is per- 
formed. Therefore, it is possible that the retrieved data being 
browsed by the user has already been modified by another 
application. 


If the RR level is specified and the AUTOCOMMIT option is 
'NO', no other DB2 application executing concurrently can 
change any of the selected database values until the SPUFI 
user issues either a COMMIT or a ROLLBACK. Therefore, other 
applications might be in a normal wait state while the SPUFI 
user is browsing the output data set. 


if the cursor stability (CS) level is specified, it does not make 
any difference whether the AUTOCOMMIT option is 'YES' or 
‘NO'. Other concurrently executing DB2 applications can 
change the selected database values as soon as the SELECT 
has completed. 


co Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNESP02 


le End of Internal DB2 Information a 


System Action: SPUFI waits until the user specifies either 'RR' 
or ''CS'. 


User Response: Type in the correct entry, and press 'ENTER'. 


DSNE366A ONLY THE LISTED RECFM TYPES ARE ALLOWED 


Explanation: The user has entered an invalid record format for 
the output data set. 


| = Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESP02 


eee End of Internal DB2 Information ee ote 


System Action: The system waits until the user enters one of 
the allowed RECFM types. 


User Response: Enter a RECFM of V, VB, VBA, F, FB, or FBA. 


DSNE367A ACTION MUST BE C (COMMIT) OR R (ROLLBACK) 
OR D (DEFER) 


Explanation: This message requests the user to make a 
commit action decision. 
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| Internal DB2 Information ” | 
This message is issued by the following CSECT(s): DSNESP03 


fo End of Internal DB2 Information Se Seon 


User Response: To commit all the changes made since the last 
commit point, enter a 'C'. To undo all the changes that have 
been made since the last commit point, enter an 'R'. To defer 
the decision, enter a blank. 


DSNE368A YES OR NO MUST BE ENTERED FOR EACH PROC- 
ESSING OPTION 


Explanation: One of the processing options was left blank or 
set to blank by the user. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESPO1 


Were aes eae End of Internal DB2 Information ee 


User Response: Enter 'YES' or 'NO' for each processing 
option. 


DSNE370A_ INPUT DATA SET COULD NOT BE OPENED 


Explanation: The input data set could not be opened because 
of invalid data set attributes. The logical record length (LRECL) 
of the input data set must be 80K. The record format (RECFM) 
must be either F or FB. The input data set may be either 
sequential or partitioned. 


[ — Internal DB2 Information Se | 
This message is issued by the following CSECT(s): DSNESM55 


ee End of Internal DB2 Information ee eal 


User Response: Specify an input data set having valid attri- 
butes. 


DSNE371A OUTPUT DATA SET COULD NOT BE OPENED 


Explanation: The output data set could not be opened because 
of invalid data set attributes. The logical record length (LRECL) 
must be at least 80K and less than 32K. The record format 
(RECFM) must be F, FB, FBA, V, VB, or VBA. The output data 
set must be sequential. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM55 


tee eo End of Internal DB2 Information bee seein 


User Response: Either specify an output data set having valid 
attributes, or enter correct attributes for this data set. 


DSNE372A OUTPUT DATA SET MUST BE SEQUENTIAL 


Explanation: The user has requested that a nonsequential 
output data set contain the output from execution of SQL state- 
ments. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM55 


ee End of Internal DB2 Information | 


User Response: Enter the data-set-name of a sequential data 
set for the output data set. 


DSNE374A OUTPUT DATA SET MUST BE SEQUENTIAL 


Explanation: The output data set is of unrecognized organiza- 
tion. It must be sequential. 


| Internal DB2 Information eT 
This message is issued by the following CSECT(s): DSNESM55 


a ae End of Internal DB2 Information See: 


System Action: Processing does not begin until! the panel 
entries are correct and the user presses 'ENTER'. 


User Response: The output data set must be sequential. Enter 
a sequential data-set-name (no member) in the output data set 
field. 


DSNE375A ACCESS TO INPUT DATA SET NOT AUTHORIZED 


Explanation: A locai installation-supplied exit has rejected 
access to the input data set specified by the user. 


i. 9 = Internal DB2 Information aia 
This message is issued by the following CSECT(s): DSNESM55 


anette End of Internal DB2 Information ae a 


User Response: Either specify the name of a data set for which 
authorization will be allowed, or arrange to authorize the ori- 
ginal data-set-name. Resubmit the request. 


DSNE376A ACCESS TO OUTPUT DATA SET NOT AUTHOR- 
IZED 


Explanation: A local installation-supplied exit has rejected 
access to the output data set. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM55 


a? End of Internal DB2 Information eee! 


User Response: Either specify the name of a data set for which 
authorization will be allowed, or arrange to authorize the ori- 
ginal data-set-name. Resubmit the request. 


DSNE374A — DSNE381A 


DSNE377A INPUT DATA SET RECFM MUST BE F OR FB WITH 
LRECL 79 OR 80 


Explanation: The user specified an input data set that does not 
have the required attributes (F or FB with LRECL 79 or 80). 


Note: Ifthe input data set has an LRECL of 79, SPUFI assumes 
the data set was exported by QMF. Therefore, it is recom- 
mended that you should not use an LRECL of 79 for a data set 
that is not exported from QMF. 


Internal DB2 Information oats | 
This message is issued by the following CSECT(s): DSNESM55 


ee End of internal DB2 Information ee el 


User Response: Correct the input data set attributes, and try 
again. 


DSNE378A ASA CONTROL CHARACTER NOT ALLOWED ON 
INPUT DATA SET RECFM 


Explanation: The user attempted to use an input data set con- 
taining forms control characters or machine control characters. 
These characters are not allowed on the input data set. 


eee Internal DB2 Information ens 
This message is issued by the following CSECT(s): DSNESM55 


=a End of Internal DB2 Information eee 


User Response: Remove the forms control characters or 
machine control characters from the input data set, and try 
again. 


DSNE379A _ text from DYNALLOC 


Explanation: An attempt to allocate a data set has failed. This 
message contains the secondary explanation for the failure. 


| = Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM55 


a End of internal DB2 Information en 


User Response: Correct the condition, and resubmit the sub- 
command. 


DSNE381A UNEXPECTED ALLOCATION RETURN CODE 
return-code, reason-code 


Explanation: An unexpected return code from SVC 99 was 
received. The return code received is the DYNALLOC (SVC 99) 
return code. Refer to the appropriate MVS publication for 
explanations of the return and reason codes. 
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DSNE383A — DSNE389A 


_- -— ~~ Internal DB2 Information oe Nn 
This message is issued by the following CSECT(s): DSNESM55 


rs End of Internal DB2 Information _ id 


User Response: Correct the condition, and resubmit the sub- 
command. 


DSNE383A INVALID OUTPUT DATA SET RECORD FORMAT. 


OPEN RETURN CODE rcode 


Explanation: The data set format was invalid. Acceptable 
record formats are: F, FB, FBA, V, VB, or VBA. 


Internal DB2 Information ~~ ~ - | 
This message is issued by the following CSECT(s): DSNESM55 


a End of Internal DB2 Information fee ee 


User Response: Enter a valid value in the record format field. 


DSNE384A UNEXPECTED DEALLOCATION RETURN CODE 
return-code, reason-code 


Explanation: A deallocation request has returned an unex- 
pected return and reason code. 


ie eo Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM55 


[ise toes ee End of Internal DB2 Information eee ees 


User Response: Refer to the appropriate MVS publication for 
explanations of the return and reason codes. 


DSNE385A ENTER MEMBER NAME. INPUT DATA SET IS PAR- 
TITIONED 


Explanation: The input data set is partitioned, and the user did 
not enter the member name on the SPUFI main menu. 


i. a ~~ Internal DB2 Information ~~ a | 
This message is issued by the following CSECT(s): DSNESM55 


Wee ees End of Internal DB2 Information ee, 


System Action: Processing does not begin until the panel 
entries are correct. If any of the processing options are 
changed, this message is ignored, and processing will proceed 
according to the new settings. 


User Response: Enter the member name. 
DSNE386A MEMBER member-name NOT PRESENT IN SPECI- 


FIED INPUT DATA SET 


Explanation: The named member is not in the input data set. 


3-34 DB2 Messages and Codes 


| = Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNESM55 


———e End of Internal DB2 Information ee ee 


System Action: Processing does not begin until the panel 
entries are correct. 


User Response: Enter a correct member name or a correct 
data-set-name. 


DSNE3871 DSNTIAR ERROR. RETURN CODE = return-code 


Explanation: An internal DB2 error has occurred. DSNTIAR 
attempted to format a message to explain a nonzero SQL code, 
but the attempt failed. 


Internal DB2 Information j | 
This message is issued by the following CSECT(s): DSNESM40 


ae End of Internal DB2 Information eee 


User Response: Notify the system programmer. 


System Programmer Response: Print the ISPF log, and collect 
a dump of the TSO address space. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DSNE388A INPUT DATA SET MUST BE SEQUENTIAL OR PAR- 


TITIONED 


Explanation: The input data set organization is not recognized. 


| ; : Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNESM55 


ee End of Internal DB2 Information ee 


System Action: Processing does not begin until the panel 
entries are correct. 


User Response: Enter a data-set-name with sequential or par- 
titioned organization. !t may be necessary to allocate a 
sequential or partitioned data set. 


DSNE389A A MEMBER HAS BEEN SPECIFIED FOR A 
SEQUENTIAL DATA SET 


Explanation: The user has specified a member as input to 
SPUFI. However, the input data set specified is sequential. 


fe — == internal DB2 Information aaa || 
This message is issued by the following CSECT(s): DSNESM55 


[he fee End of Internal DB2 Information rae ee 


System Action: Processing does not begin until the panel 
entries are correct. 


User Response: Enter the data-set-name without attempting to 
specify a member. 


DSNE390A THE OUTPUT DATA SET ATTRIBUTES ARE INCON- 
SISTENT 


Explanation: This message indicates that the user made one of 
three possible errors in specifying block size and logical record 
length (LRECL): 


¢ The user specified a record format (RECFM) of F, but the 
block size is not equal to the logical record length (LRECL) 

¢ The user specified a record format (RECFM) of F, FB, or 
FBA, but block size is not evenly divisible by logical record 
length (LRECL). 

¢ The user specified a record format (RECFM) of VB, but the 
block size is less than logical! record length (LRECL) + 4. 
The user must allow 4 bytes for the block header. 


| ~~ Internal DB2 Information ~ il 
This message is issued by the following CSECT(s): DSNESM55 


(ete ta End of Internal DB2 Information So es 


User Response: Specify logical record length (LRECL) and 
block size appropriately on the DSNESP02 panel. 


DSNE3911 FREEMAIN ERROR IN MODULE module-name 


Explanation: SPUFI encountered a FREEMAIN error in the 
specified module. 


| te Internal DB2 Information a —— 
This message is issued by the following CSECT(s): DSNESM90 


es End of Internal DB2 Information een 


System Action: This message is logged in the ISPF log data 
set. No abend occurs. 


User Response: Notify the system programmer or system 
administrator. 


System Programmer Response: Print the iSPF log, and collect 
a dump of the TSO address space. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DSNE392I GETMAIN ERROR IN MODULE module-name 


Explanation: SPUFI encountered a GETMAIN error in the spec- 
ified module. 


[feo Internal DB2 Information ee ett 
This message is issued by the following CSECT(s): DSNESM00 
eles ected End of Internal DB2 Information Bt hs 
System Action: This message is logged in the ISPF log data 


set. User abend X'00C50003' is issued. 


User Response: Notify the system programmer or system 
administrator. 


System Programmer Response: Ensure that enough storage is 
allocated to the TSO user. 


DSNE390A — DSNE396A 


DSNE3931 SPF VDELETE ERROR IN MODULE DSNESM90. 


ERROR CODE = flag 


Explanation: An internal SPUF! error has occurred. CSECT 
DSNESM6¢90 tried to delete an ISPF dialog variable that was not 
previously defined. 


= ee Internal DB2 Information ee ee 
This message is issued by the following CSECT(s): DSNESMS90 


rae End of Internal DB2 Information ers 


System Action: This message is logged in the ISPF log data 
set. No abend is issued. However, if the problem persists, 
notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Record the error code 'flag'. It has 
no user significance, but it can assist the IBM Support Center in 
resolving the problem. 


DSNE395| UNEXPECTED RETURN CODE FROM SPF 


SERVICE 


Explanation: A return code of 4 from ISPF DISPLAY or a return 
code of 8 from the ISPF editor was encountered. 


—_ Internal DB2 Information - : | 
This message is issued by the following CSECT(s): DSNESMOO 


Ls End of Internal DB2 Information = 


System Action: The message is displayed on the SPUFI panel 
and logged in the ISPF log data set. No user abend is issued. 


User Response: Notify the system programmer. 


System Programmer Response: If anew release of ISPF is 
used, determine whether the above return codes are now 


- assigned meaning by ISPF. 


Probiem Determination: This message may be issued if a pre- 
viously unassigned (by !SPF) return code from the SPF 
DISPLAY or EDIT function is encountered. If a new release of 
ISPF is used, determine whether the above return codes are 
now assigned meaning by ISPF. 


DSNE396A YOU CANNOT SPECIFY DEFER WHEN LEAVING 
SPUFI 


Explanation: You have attempted to leave SPUFI with out- 
standing database changes not yet committed or rolled back. 
You can’t leave SPUFI unless a decision has been made to 
commit or rollback. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESMO00O 


a End of Internal DB2 Information eet 


System Action: The system is waiting for new input to the 
panel. 


User Response: Specify COMMIT or ROLLBACK. 
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DSNE415A — DSNE605E 


DSNE415A__—scsect-name TYPE IS DATE 


Explanation: This is a SPUF/ trace message. SPUFI has looked 
in the SQLTYPE field of the SQLDA and detected a data type of 
DATE. 


| Internal DB2 Information | 


This message is issued by the following CSECTs: DSNESM30, 
DSNESM32 


a End of Internal DB2 Information Be eee 


DSNE416A__scsect-name TYPE IS TIME 


Explanation: This is a SPUFI trace message. SPUFI has looked 
in the SQLTYPE field of the SQLDA and detectéd a data type of 
TIME. 


— Internal DB2 Information | 


This message is issued by the following CSECTs: DSNESM30, 
DSNESM32 


ee End of Internal DB2 Information ee, 


DSNE417A__scsect-name TYPE !S TIMESTAMP 


Explanation: This is a SPUFI trace message. SPUFI has looked 
in the SQLTYPE field of the SQLDA and detected a data type of 
TIMESTAMP. 


[ " Internal DB2 Information a5 5, 


This message is issued by the following CSECTs: DSNESM30, 
DSNESM32 


Pe te ee End of internal DB2 Information reas al 


DSNE457! _—csect-name ARITHMETIC ERROR IN THE 


CURRENT ROW AND COLUMN 


Explanation: This is a SPUFI trace message. SPUFI has looked | 


in the SQLDA and detected an arithmetic error. The indicator 
variable associated with this value contains -2. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM30 


{| End of Interna! DB2 Information Pcans san 


DSNE6011 SQL STATEMENTS ASSUMED TO BE BETWEEN 


COLUMNS nn AND nn 


Explanation: This message indicates which record columns in 
the input data set are scanned for SQL statements. For data 
sets of type COBOL, columns 8 through 72 are scanned. For 
STANDARD data set types, if the 1rec1 is 79 then columns 1 
through 71 are scanned, and if the 1reci is 80 then columns 1 
through 72 are scanned. 


3-36 DB2 Messages and Codes 


| Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNESM41 


ee eas End of internal DB2 Information een 


System Action: This message is written to the SPUFI output 
data set along with other summary messages. 


DSNE603E INPUT STATEMENT HAS UNBALANCED APOS- 


TROPHES 


Explanation: An opening apostrophe was detected in an input 
record, but the end of data set was reached before a closing 
apostrophe was encountered. 


[ ~— Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNESM21 


aes End of Internal DB2 Information eh ee ets 


System Action: SPUFi processing stops. Correct the error, and 
Start again. 


User Response: A closing apostrophe was probably omitted 
from a literal value. Add the missing apostrophe, and execute 
the input file again. 


DSNE604E THE SQL STATEMENT EXCEEDS THE MAXIMUM 
ALLOWED LENGTH 


Explanation: This message indicates that the preceding SQL 

statement in the output data set exceeds the maximum length 

allowed. An SQL statement may span up to a maximum of 455 
input records. 


Internal DB2 Information A 
This message is issued by the following CSECT(s): DSNESM21 


ee End of Internal DB2 Information Reaetet eee 


System Action: SPUFIi processing stops. Correct the error, and 
start again. 


User Response: Edit the SQL statement in question so that it 
resides on fewer input records. 


DSNE605E THE INPUT DATA SET IS EMPTY 


Explanation: The user has specified an input data set that does 
not contain any valid SQL statements. 


| - — Internal DB2 Information :  e 7 
This message is issued by the following CSECT(s): DSNESM21 


(ee ed, End of Internal DB2 Information eee ll 


System Action: SPUFI processing stops. Correct the error, and 
start again. 


User Response: Edit SQL statements into the specified data 
set, or specify another input data set that contains valid SQL 
statements. 


DSNE606E INVALID USE OF SEMI-COLON DETECTED 


Explanation: A semicolon has been used improperly in an SQL 
input statement. Either two successive semicoions were 
encountered, or a series of blanks followed by a semicolon was 
detected. The proper use of the semicolon is to delimit the end 
of a valid SQL statement. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM21 


ES eee oes End of Internal DB2 Information Seo eae 2) 


System Action: SPUFI processing stops. Correct the error, and 
start again. 


User Response: Remove the extraneous semicolon from the 
input data set. 


DSNE607E PREVIOUS INPUT RECORD HAS UNBALANCED 


SO/SI CHARACTERS 


Explanation: A shift out (SO) character was detected in the 
previous input record with no corresponding shift in (SI) char- 
acter in the record. The SO/SI characters delimit a DBCS string 
in the SPUFI input data set. SPUFI requires that SO/SI charac- 
ters be paired within an input record. 


per ee Sa Internal DB2 Information noe a 5 
This message is issued by the following CSECT(s): DSNESM21 


[lee Ste ee, End of Internal DB2 Information See etd 


System Action: SPUF! processing stops. 


User Response: A closing SI character was probably omitted 
from a literal value. Add the missing SI character, and re- 
execute the input file. 


DSNE609E INPUT STATEMENT HAS UNBALANCED QUOTES 


Explanation: An opening quote (“) was detected in an input 
record, but a corresponding quote was not found at the end. 
Two sets of quotes are used to delimit a statement. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM21 


Ls End of Internal DB2 Information ____——_| 


System Action: SPUFI processing stops. 


User Response: A closing quote was probably omitted froma 
literal value. Add the missing quote, and execute the input file 
again. 


DSNE610i NUMBER OF ROWS DISPLAYED IS nn 


Explanation: Execution of an SQL SELECT statement causes 
one or more rows of data to be displayed. This message 
appears in the output data set following the returned data for a 
SELECT. It gives a count, 'nn', of the number of rows dis- 
played. 


DSNE606E — DSNE612I 


| Internal DB2 Information aa 
This message is issued by the following CSECT(s): DSNESM40 


[ae ee oe End of Internal DB2 Information ee ee 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


DSNE6111 COLUMN HEADER FOR COLUMN NUMBER nn 


WAS TRUNCATED 


Explanation: An SQL SELECT statement was executed, but the 
specified column name, identified by 'nn' in the message, was 
truncated. This truncation occurred either because the column 
name was longer than the remaining record width or because 
the name was longer than the user-specified maximum field 
length. 


Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNESM40 


{ End of Internal DB2 Information eueenee| 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


User Response: If the truncation is caused by insufficient 
record width, use a larger LRECL for the output data set or 
specify fewer data columns to be returned on the SELECT state- 
ment. 


if the truncation is caused by the user-specified maximum field 
length setting, use a larger value for this setting. 


DATA FOR COLUMN HEADER name COLUMN 
NUMBER nn WAS TRUNCATED 


DSNE6121 


Explanation: An SQL SELECT statement was executed, but 
data for the specified column name, identified by 'nn' in the 
message, was truncated. This truncation occurred either 
because the data was longer than the remaining record width 
or because the data was longer than the user-specified 
maximum field length. 


| Internal DB2 Information : | 


This message is issued by the following CSECT(s): DSNESM40 


PS pees End of Internal DB2 Information fig ee 8 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


User Response: Ifthe truncation is because of insufficient 
record width, use a larger LRECL for the output data set or 
specify fewer data columns be returned on the SELECT state- 
ment. 


If the truncation is because of the user-specified maximum field 
length setting, use a larger value for this setting. 
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DSNE613I — DSNE620I 


DSNE6131 OUTPUT LRECL IS TOO SMALL TO DISPLAY THE 


FOLLOWING COLUMNS: 


Explanation: An SQL SELECT statement was executed, but the 
logical record length of the output data set was not large 
enough to dispiay the column names and data values of all 
returned columns. The columns specified following this 
message were not displayed because of insufficient remaining 
record width. - 





| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNESM40 


bor. tes tes End of Internal DB2 Information ed 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


User Response: This condition can be avoided by using a 
larger LRECL for the output data set or by specifying that fewer 
data columns be returned on the SELECT statement. 


DSNE6141 AUTOCOMMIT IS NO, NO CHANGES COMMITTED 


Explanation: The user delayed committing or rolling back 
changes made during execution of the input file until later in the 
session. This is done by specifying an AUTOCOMMIT option of 
'NO'. 


| ; ~~ Internal DB2 Information ~~~ | 
This message is issued by the following CSECT(s): DSNESM40 


eee End of Internal DB2 Information re 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


User Response: Commit or roll back these changes before 
ending the session. 


DSNE615| NUMBER OF ROWS AFFECTED IS nn 


Explanation: This message is written to the output data set fol- 
lowing execution of an SQL UPDATE, INSERT, or DELETE state- 
ment. 'nn' in the message is a count of the number of rows 
that were modified as a result of executing the UPDATE, 
INSERT, or DELETE statement. 


‘. Internal DB2 Information ——* Z | 
This message is issued by the following CSECT(s): DSNESM40 


Ne es End of Internal DB2 Information be te el 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


DSNE6161 STATEMENT EXECUTION WAS SUCCESSFUL, 


SQLCODE IS number 


Explanation: This message is written to the output data set fol- 
lowing the successful execution of an SQL statement from the 
input data set. 'number' specifies the SQL return code for the 
statement. These return codes are listed in “Section 2. SQL 
Return Codes” and on DB2lI online HELP panels. 
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(a. Internat DB2 Information et Va 
This message is issued by the following CSECT(s): DSNESM40 


= End of Internal DB2 Information | 


System Action: Input data set processing is completed, and 
this message is included in the SPUF! output. 


DSNE6171 COMMIT PERFORMED, SQLCODE IS number 


Explanation: When an input file is executed successfully and 
the user specified an AUTOCOMMIT option of 'YES', this 
message is written to the output data set to indicate the status 
of the COMMIT that was performed. 'number' specifies the 
SQL return code for the COMMIT. These return codes are listed 
in “Section 2. SQL Return Codes” on page 2-1 and on DB2l 
online HELP panels. 


a Internal DB2 tnformation | 
This message is issued by the following CSECT(s): DSNESM40 


Pon se pete End of Internal DB2 Information a 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


DSNE618i ROLLBACK PERFORMED, SQLCODE IS number 


Explanation: When an error is encountered while executing a 
SPUFI input file, and the user specified an AUTOCOMMIT option 
of 'YES', this message will be written to the output data set to 
indicate the status of the ROLLBACK that was performed. 
‘number' specifies the SQL return code for the statement. 
These return codes are listed in “Section 2. SQL Return Codes” 
on page 2-1 and on DB2i online HELP panels. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESM40 


lS eee End of Internal DB2 Information ee 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


DSNE6201 NUMBER OF SQL STATEMENTS PROCESSED IS 


Explanation: This message is written to the output data set 
after processing all SQL statements in the current input data 
set. The term 'nn' is a count of the number of SQL statements 
processed. 


ee Internal DB2 Information ne 
This message is issued by the following CSECT(s): DSNESM41 


reir eres End of internal DB2 Information | 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


DSNE621| NUMBER OF INPUT RECORDS READ IS nn 


Explanation: This message is written to the output data set 
after processing all SQL statements in the current input data 
set. The term 'nn' is a count of the total number of records 
read from the input data set. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNESM41 


po End of Internal DB2 Information _ sid 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


DSNE622|. NUMBER OF OUTPUT RECORDS WRITTEN IS nn 


Explanation: This message is written to the output data set 
after processing all SQL statements in the current input data 
set. The term 'nn' is a count of the total number of records 
written to the output data set. 


i — Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNESM41 


Te heteee So End of Internal DB2 Information ete 


System Action: Input data set processing is completed, and 
this message is included in the SPUFI output. 


DSNE623! 


Explanation: A syntax error was detected in the SQL statement 
preceding this message in the output data set. 'xx' identifies 
the erroneous line number in the SQL statement, and ‘yy' iden- 
tifies the offset (in characters) of the error within that record. 


SYNTAX ERROR AT RECORD xx, OFFSET xx 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNESM40 


te yee eae! End of Internal DB2 Information _ sid 


System Action: input data set processing is completed, and 
this message is included in the SPUFI output. 


User Response: Correct the specified syntax error in the input 
data set, and execute the job again. 


DSNE6241 UNABLE TO LOAD ISPLINK MODULE. SPUFI 


PROCESSING TERMINATED 


Explanation: During SPUFI initialization processing, an error 
was encountered attempting to LOAD the ISPF interface 
module, ISPLINK. This module could not be located in the 
LNKLST or STEPLIB library concatenation. 


DSNE6211 — DSNE804A 


| ” Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP10 


Pee ee End of Internal DB2 Information _ 


System Action: SPUF! processing is terminated. 


User Response: Rearrange your library concatenation so that 
the ISPLINK module can be located. This module resides in the 
ISPF load library. 


DSNE800A NO DEFAULT VALUES WERE CHANGED. PRESS 
ENTER TO CONTINUE 


Explanation: The user left panel DSNESP02 without changing 
it. This panel contains all the defaults that can be modified by 
the user. 


ae Internal DB2 Information i ea 
This message is issued by the following CSECT(s): DSNESMO00 


Nese a ee End of Internal DB2 Information ee ee 


System Action: This message is presented on the SPUFI pane! 
DSNESP01. SPUFI waits for the next user input. 


User Response: Press 'ENTER' if you want to continue. 


DSNE803A INPUT FILE WAS NOT CHANGED. PRESS ENTER 
TO CONTINUE 


Explanation: The user has exited from the ISPF editor without 
modifying the input data set. 


[ Se Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESMO0O 


Boe Bes End of Internal DB2 Information Sea 


System Action: The system waits for the next user input. 


User Response: Press 'ENTER' if you want to continue. The 
SPUFI panel variable settings can be changed at this point. 


DSNE804A TO CONTINUE, C (COMMIT) OR R (ROLLBACK) 
MUST BE SPECIFIED 


Explanation: The user has specified the AUTOCOMMIT = NO 
option and now wants either to exit or to switch to another DB2 
subsystem with outstanding work uncommitted on the current 
DB2 subsystem. 


| : Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNESMO0 


Mee wa eines End of Internal DB2 Information aa 


System Action: DB2 waits for the user to specify either the 
COMMIT (C) or the ROLLBACK (R) option. 


User Response: Enter 'C' or 'R' to continue. 
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DSNE808A — DSNE922E 


DSNE808A EDIT SESSION HAS COMPLETED. PRESS ENTER 
TO CONTINUE. 


Explanation: The user has exited from the ISPF editor. 


Internal DB2 Information ~~ _ ae 
This message is issued by the following CSECT(s): DSNESMO00 


| Ena of internal DB2 Information ________| 


System Action: SPUFI waits form the next user input. 


User Response: Press ‘Enter’ if you want to continue. Press 
'END' if you want to terminate your SPUF! session. The SPUFI 
panel variable settings can be changed at this point. 


DSNE901I EXECUTION COMPLETE 


Explanation: Execution of a subcommand has successfully 
completed. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP14 


a End of internal DB2 Information Be Aes as 


System Action: The TSO attachment facility is ready for more 
input. 


DSNE9031 WARNING, DECLARATION HAS SAME NAME AS 


TABLE tabie-name 


Explanation: A DCLGEN subcommand has a 'STRUCTURE' 
parameter that is the same as the 'table name' specified in the 
message. The requested declaration has been created, but this 
could cause conflicts with internal names. 


| Internal DB2 Information ~ ciare | 


This message is issued by the following CSECT(s): DSNECP61, 
DSNECP62 


(ee ee et End of Internal DB2 Information et se 


System Action: DCLGEN execution continues. 


User Response: Choose a different 'STRUCTURE' parameter. 


DSNE9041 EXECUTION COMPLETE, MEMBER member-name 


REPLACED 


Explanation: A DCLGEN subcommand executed successfully, 
replacing the 'member-name' specified in the message. 


| Internal DB2 Information ~~ ee 
This message is issued by the following CSECT(s): DSNECP14 


| End of Internal DB2 Information Sd 
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System Action: The TSO attachment facility is ready for more 
input. 


DSNE9051 EXECUTION COMPLETE, MEMBER member-name 


ADDED 


Explanation: A DCLGEN subcommand executed successfully, 
adding the 'member-name' specified in the message to the 
data set specified in the DCLGEN subcommand. 


Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNECP14 


aa aos End of Internal DB2 Information ae 


System Action: The TSO attachment facility is ready for more 
input. 


DSNE920E member-name ALREADY EXISTS, SPECIFY 
ACTION(REPLACE) TO REPLACE 


Explanation: The DCLGEN user tried to overwrite an old decia- 
ration with a new one without specifying REPLACE on the 
‘ACTION' parameter. 


Internal DB2 Information >~> | 
This message is issued by the following CSECT(s): DSNECP69 


L End of Interna! DB2 Information ae 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Change the 'ACTION' parameter to REPLACE 
(if that’s actually what you want to do), and resubmit the 
command. 


DSNE921E REQUIRED PARAMETER table-parameter IS 
MISSING 


Explanation: Your DCLGEN subcommand was missing the 
required TABLE parameter. 


| Internal DB2 Information . 
This message is issued by the following CSECT(s): DSNECP24 


| Ss End of Internal DB2 Information _____—_| 


System Action: Your DCLGEN subcommand was not proc- 
essed. The DSN command processor issued a return code of 8. 
DSN is ready for more input. 


User Response: Resubmit the DCLGEN subcommand with a 
TABLE parameter. 


DSNE922E TABLE NAME QUALIFIER OF qualifier IS TOO 
LONG. CANNOT EXCEED 8 CHARACTERS IN 
LENGTH 


Explanation: DCLGEN detected an invalid TABLE parameter. 
The table name qualifier (the left portion of the table name) was 
too long. 


V2” ap Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP24 


Des elo End of Internal DB2 Information ess 


System Action: Your DCLGEN subcommand was not proc- 
essed. The DSN command processor issued a return code of 8. 
DSN is ready for more input. 


User Response: Resubmit the DCLGEN subcommand with a 
shorter table name qualifier. 


DSNE923E CSECT csect-name FOUND AN UNRECOGNIZED 
LANGUAGE unknown 


Explanation: This is a DCLGEN subsystem error, not a user 
error. The language parameter ‘unknown’ is not known to the 
subsystem. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNECP14, 
DSNECP60 


Eos! theses End of Interna! DB2 Information eee | 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Report the problem to the system pro- 
grammer. 


System Programmer Response: Re-create the probiem with 
DSN tracing turned on. Collect the trace stream in the 
DSNTRACE data set. Use the ABEND subcommand of the DSN 
command processor to collect a dump. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


DSNE924E PARSE FAILED IN CSECT csect-name PARAM- 


ETER parm, FLAG flag 


Explanation: This is a DB2 subsystem error, not a user error. 
The 'PARM' parameter was not correctly parsed. The flag 
specified was detected as an inappropriate value in a parse 
results fieid. 


| internal DB2 Information | 


This message is issued by the following CSECT(s): DSNECP21, 
DSNECP24, DSNECP26, DSNECP40, DSNECP41, DSNECP42 


eee End of Internal DB2 Information Stiote= =| 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Report the problem to the system pro- 
grammer. 


System Programmer Response: Re-create the problem with 
DSN tracing turned on. Collect the trace stream in the 
DSNTRACE data set. Use the ABEND subcommand of the DSN 

- command processor to collect a dump. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


DSNE923E — DSNE928E 


DSNE925E BUFFER OVERFLOW IN CSECT csect-name WHILE 
WRITING string 


Explanation: This is a DCLGEN subsystem error. CSECT 
‘csect-name' detected a buffer overflow condition while 
attempting to write 'string'. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNECP67 


Ls End of Internal DB2 Information _____——_—| 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Notify the system programmer. 


System Programmer Response: Re-create the problem with 
DSN tracing turned on. Collect the trace stream in the 
DSNTRACE data set. Refer to Section 5 of Diagnosis Guide and 
Reference for failure analysis procedures. 


DSNE926E COMMAND REJECTED command NOT SUP- 


PORTED UNDER subsystem 


Explanation: The user entered a TSO TIME or TEST command. 
These are not supported by DSN or DB2lI. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP31 


[eet gees End of Internal DB2 Information pepsi al 


System Action: The user should leave DSN or DB2i, return to 
TSO, and retry the command. DSN can be run under TSO TEST. 
The TSO attachment facility is ready for more input. 


User Response: Enter the DSN subcommand, or leave DSN to 
execute the requested command. 


DSNE927E RUN SUBCOMMANDS REQUIRE (1)PROGRAM 


PARM OR (2)PLAN AND CP PARMS 


Explanation: RUN subcommands may contain (1) the 
‘PROGRAM ' parameter and, optionally, the 'PLAN' parameter | 
or (2) the 'PLAN' and command processor ('CP') parameters. 
Combinations of (1) and (2) are not allowed. 


| Internal DB2 Information —* | 
This message is issued by the following CSECT(s): DSNECP26 


etre Sees End of Internal DB2 Information eee 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Correct the subcommand, and resubmit the 
job. 


DSNE928E RUN SUBCOMMANDS CANNOT HAVE A 
PROGRAM PARM AND A CP PARM 


Explanation: A RUN subcommand cannot contain both the 
'PROGRAM' and command processor ('CP') parameters. The 
subcommand should be resubmitted with only one of the 
parameters. 
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- DSNE929E — DSNE934I 


| internal DB2 Information : | 
This message is issued by the following CSECT(s): DSNECP26 


[atte ee ets End of Internal DB2 Information eee | 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Correct the subcommand, and resubmit the 
job. 


DSNE929E TABLE NAME LOCATION OF (location-name) IS 
TOO LONG. CANNOT EXCEED 16 CHARACTERS IN 
LENGTH. 


Explanation: DCLGEN detected an invalid AT(location) 
keyword parameter. The specified location name is too long. 


[ ae ~ ~ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP24 


[et eons End of Internal DB2 Information ee 


System Action: Your DCLGEN subcommand was not proc- 
essed. The DSN command processor issues a return code of 8. 
The DSN is ready for more input. 


User Response: Resubmit the DCLGEN subcommand speci- 
fying a location name that does not exceed 16 characters. 


DSNE930E TABLE NAME OF table-name MUST BE QUALI- 


FIED WHEN SPECIFIED WITH LOCATION OF 
location-name 


Explanation: DCLGEN detected an invalid TABLE keyword 
parameter. You must specify a qualified table name with the 
AT(location)keyword. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP24 


eee End of Interna! DB2 Information | 


System Action: Your DCLGEN subcommand was not proc- 
essed. The DSN command processor issues a return code of 8. 
DSN is ready for more input. 


User Response: Specify a qualified table name and resubmit 
the DCLGEN command. 


DSNE931E PLAN NAME plan-name CONTAINS AN INVALID 
SYMBOL (x) 


Explanation: Plan names must be alphameric and fewer than 
nine characters long. They should not begin with a digit. In this 
context, national characters are not considered alphabetic. 
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| internal DB2 Information | 


This message is issued by the following CSECT(s): DSNECP40, 
DSNECP41, DSNECP42 


a End of Internal DB2 Information Sate one ant 5 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Check the plan-name, and resubmit the job, 
as necessary. 


DSNE9321 WARNING, ONLY IBM SUPPLIED PLAN NAMES 


SHOULD BEGIN WITH DSN 


Explanation: The user has issued a BIND, REBIND, or FREE 
subcommand, using a plan-name that begins with DSN. 


| Internal DB2 Information - | 


This message is issued by the following CSECT(s): DSNECP40, 
DSNECP41, DSNECP42 


ee End of Internal DB2 information ee 


System Action: Processing continues. 


User Response: in the future, do not use plan-names that 
begin with DSN. It would be a good idea to FREE the plan you 
just created and to BIND again with a new plan-name. 


DSNE933E PLAN NAME plan-name DOES NOT BEGIN WITH 


AN ALPHABETIC CHARACTER 


Explanation: The first character of the plan-name must be an 
alphabetic character, but it was not. 


| Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): DSNECP40, 
DSNECP41, DSNECP42 


ls Ss aes End of Internal DB2 Information ee 


System Action: The TSO attachment facility is ready for more 
input. 


User Response: Correct the plan-name, and retry the DSN sub- 
command that failed. 


DSNE9341 BIND, REBIND, OR FREE PROCESSING WILL NOT 


BE ATTEMPTED 


Explanation: An invalid plan-name was submitted. Valid plan- 
names are one to eight characters long and contain only alpha- 
numeric characters. The first character must be alphabetic. 


| Internal DB2 Information —— ] 


This message is issued by the following CSECT(s): DSNECP40, 
DSNECP41, DSNECP42 


es End of Internal DB2 Information ee Selec 


System Action: . The TSO attachment facility is ready for more 
input. 


User Response: Reenter the subcommand with a valid plan- 
name. 


DSNE9Q35I ... IS THE DCLGEN COMMAND THAT MADE THE 


FOLLOWING STATEMENTS 


Explanation: This message is a part of normal DCLGEN output. 
It identifies the DCLGEN command that produced the deciara- 
tion of which it is a part. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNECP14 


————— End of Internal DB2 Information Seed 


System Action: This message is included in the DCLGEN 
output. 


DSNE9361 THE NUMBER OF COLUMNS DESCRIBED BY THIS 


DECLARATION IS nnn 


Explanation: This message is a part of normal DCLGEN output. 
It tells how many columns were in the table that was named in 
the DCLGEN command. 


| Internal DB2 Information eee ae 
This message is issued by the following CSECT(s): DSNECP14 


Vite Mees End of Internal DB2 Information ed 


System Action: This message is included in the DCLGEN 
output. 


DSNE937! COBOL DECLARATION FOR TABLE table-name 


Explanation: This message is a part of normal DCLGEN output. 
It tells the name of the table for which the declaration was 
created. 


Internal DB2 Information = 
This message is issued by the following CSECT(s): DSNECP61 


Te ee End of Internal DB2 Information Eee 


System Action: This message is included in the DCLGEN 
output. 


DSNE938I PLI DECLARATION FOR TABLE table-name 


Explanation: This message is a part of normal DCLGEN output. 
It tells the name of the table for which the declaration was 
created. 


~ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNECP62 


Boceeteens End of Internal DB2 Information el 


System Action: This message is included in the DCLGEN . 
output. 


DSNE935I — DSNE944I 


DSNES939E__—s csect-name THE COMBINATION 
ACQUIRE(ALLOCATE) AND RELEASE(COMMIT) IS . 


NOT ALLOWED 


Explanation: The BIND or REBIND subcommand has been sub- 
mitted with conflicting parameters. You cannot specify 
ACQUIRE(ALLOCATE) and RELEASE(COMMIT) on the same 
subcommand, because this action is not supported by DB2. 


i 7 Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNECP4O, 
DSNECP41 


eee ees End of Internal DB2 Information ee 


System Action: The subcommand is terminated and the DSN 
command processor will reissue the DSN prompt to allow 
another subcommand to be entered. 


User Response: Enter the corrected subcommand. Refer to 
Chapter 2 of Command and Utility Reference for additional 
information regarding the BIND and REBIND subcommands. 


Problem Determination: See above. 


DSNES40E DEFER(PREPARE) INVALID WITH 


NODEFER(PREPARE) 


Explanation: The BIND or REBIND subcommand has been sub- 
mitted with conflicting parameters. You cannot specify 


- DEFER(PREPARE) and NODEFER(PREPARE) on the same sub- 


command, because these actions conflict. 


[ ~ Internal DB2 information ~———— | 


This message is issued by the following CSECT(s): DSNECP40, 
DSNECP41 


ae, End of Interna! DB2 Information eo ee 


System Action: The subcommand is terminated and the DSN 
command processor will reissue the DSN prompt to allow 
another subcommand to be entered. 


User Response: Enter the corrected subcommand. Refer to 
Chapter 2 of Command and Utility Reference for additional 
information regarding the BIND and REBIND subcommands. 


Problem Determination: See above. 


DSNE9444 WARNING, BECAUSE YOUR TABLE OR COLUMN 
NAMES CONTAIN LOWER CASE OR 
NON-ALPHABETIC CHARACTERS, YOU WILL 
NEED TO USE THE SQL (NOT PL/I) INCLUDE 
STATEMENT TO INCLUDE DCLGEN OUTPUT INTO 


YOUR PROGRAM. 


Explanation: DCLGEN had to wrap your table or column 
name(s) in quotes so DB2 could process them. Quotes are not 
recognized by the PL/I compiler. To avoid compilation errors, 
use the SQL INCLUDE statement ('EXEC SQL INCLUDE 
membername') to merge the DCLGEN output with your source 
program. 


Refer to Chapter 6 of SQL Reference for more information about 
the SQL INCLUDE statement. 
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DSNE947I — DSNE951I 


cc - Internal DB2 Information a>. 
This message is issued by the following CSECT(s): DSNECP60. 


[| End of Internal DB2 Information _. | 


System Action: DCLGEN processing continues. 


User Response: If you have not coded the SQL INCLUDE, do so 
before the next compile. 


DSNE9471 QUOTE PARAMETER IS ONLY VALID WITH 


COBOL. IT HAS BEEN CHANGED TO APOST 


Explanation: You specified the DCLGEN QUOTE parameter and 
a non-COBOL language parameter. This combination is not 
valid. The QUOTE parameter was specified as either a param- 
eter on the DCLGEN subcommand or a default set for your site 
at DB2 installation time. 


The DCLGEN processor changed the QUOTE setting (for this 
run) to APOST. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNECP24. 


[snd of internal DB2 Information —___———_—| 


System Action: DCLGEN processing continues and should 
produce valid output. 


User Response: If you used QUOTE on the DCLGEN command, 
you may want to change it to APOST before submitting it again. 


DSNE948i csect-id FURTHER subcommand PROCESSING 


WILL NOT BE ATTEMPTED 


Explanation: A DSN command processor subcommand (indi- 
cated in the message) has encountered an error which stopped 
DSN from processing this subcommand. The subcommand will 
not complete normally. This message is accompanied by other 
messages explaining the exact nature of the problem. 


[oe ee Internal DB2 Information oe sce Wel 
This message is issued by the following CSECT(s): DSNECP24 


Use eeeea End of Internal DB2 Information eee | 


System Action: Subcommand processing terminates. The DSN 
prompt is reissued, indicating DSN is ready for another sub- 
command. 


User Response: Read the accompanying messages for help in 
deciding what to do next. 


DSNE949E COMMIT DISABLED DUE TO A PRIOR ERROR. 


Explanation: The DSN command processor has initiated a 
‘prepare to commit' request in DB2. The request is rejected 
when DB2 can not commit the work performed 
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Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNECP18 


ears eer End of internal DB2 Information a eee 


System Action: The commit processing is terminated. The 
work performed by the application since the last commit point 
will be backed out during the deailocation process. 


User Response: If a DB2 dump was not produced, resubmit 
your job. The problem was probably temporary; for example, 
you were selected as a deadlock victim. 


Operator Response: If a dump was produced, save it for 
further examination. 


System Programmer Response: |f a dump was produced, 
begin the normal DB2 problem and diagnosis procedure. 


Problem Determination: See above. 


DSNE950E DCLGEN DOES NOT SUPPORT THE !lang LAN- 


GUAGE 


Explanation: A DCLGEN user attempted to specify a LAN- 
GUAGE parameter, ‘lang’, that DCLGEN does not support. 


= Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNECP24 


Ue cee eat End of Internal DB2 information tl 


System Action: DCLGEN processing terminates. 


User Response: Correct the LANGUAGE parameter and 
resubmit the DCLGEN subcommand. 


DSNE9511 DCLGEN CREATED THIS COMMENT FOR dtype 
COLUMN coiname BECAUSE lang HAS NO dtype 


DATA TYPE 


Explanation: DCLGEN was building a 'lang' language declara- 
tion for a table when it encountered a column with the SQL 
'dtype' data type. Because the 'lang' language does not 
support an equivalent to the ‘dtype' data type, DCLGEN could 
not create a suitable declaration for this column. As a substi- 
tute, DCLGEN created this explanatory comment. 


re internal DB2 Information = 
This message is issued by the following CSECT(s): DSNECP63 


| Ss End of Internal DB2 Information ee 


System Action: DCLGEN set the return code to 4 and proc- 
essed the rest of the table. 


User Response: This is just a warning. Be aware that your 
declaration is missing an area corresponding to the 'dtype' 
column. Because this column has no declaration, you will not 
be able to SELECT into the structure as a whole. 


DSNE999 INVALID SQL RETURN CODE 


Explanation: The number you selected is not a valid SQL 
return code. 


DSNE999 — DSNE999 


| internal DB2 Information “| 
This message is issued by panel: DSN4SRC 


Geer eee Bee End of Internal DB2 Information Sent 


User Response: Check the number and enter it again. 
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Message Generator Messages (DSN...) 


MESSAGE GENERATOR INITIALIZATION PARAM- 
ETERS NOT FOUND. DEFAULTS ASSUMED 


DSNFO001! 


Explanation: The message generator was unable to access the 
routing code initialization parameter defined by the DSN6SYSP 
macro. Default values defined by that macro are assumed. 


| Internal DB2 Information 4 | 
This message is issued by the following CSECT(s): DSNFMGIN 


re End of Internal DB2 Information es 


System Action: Subsystem initialization continues. 
Operator Response: Notify the system programmer. 


System Programmer Response: !t may be necessary to change 
the DSN6SYSP macro invocation and replace the DSN6SYSP 
member of the DSNIPARM directory. Refer to Section 2 
(Volume 1) of Administration Guide for details of this process. 


DSNF7001I csect-name message-id HAS BEEN ISSUED 


Explanation: An unsuccessful attempt has been made to issue 
the message 'message-id'. This message is issued only if the 
requested message could not be found in the DB2 message 
directory. 


| : ~ Internal DB2 Information ae | 


This message is issued by the following CSECT(s): DSNFGENM, 
DSNFMGSS, DSNFSAMG 


ne End of Internal DB2 Information Perea eee | 


System Action: The system proceeds as though the requested 
message had been issued. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to this manual for actual 
message text. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for failure analysis procedures. You need the message 
number ('message-id'). 
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DSNH003!1 — DSNHO06I 





Precompiler and DSNH CLIST Messages (DSNH...) 


Precompiler Message Line 
Numbers 


The line number 'nnnn' in the following compiler 
messages is generated by assigning sequential 
numbers to the original source. The numbers are 
printed on the SQL precompiler source listing (if 
the SOURCE option is specified to the precom- 
piler). 


‘COL cc' in the messages identifies the source 
column in which the condition was detected. This 
is usually the location of the column containing the 
first character of the associated source token. 
However, if the precompiler cannot determine this 
location, it is the beginning of the statement. 
Because the detected error may be similar to a 
valid, but different, construction, the SQL parsing 
might indicate the wrong location for the error. 


Precompiler Message Severity 
Codes 


One of the characters W, E, S, or U is shown at the 
beginning of each precompiler message as an aid 
to the programmer. These characters indicate the 
severity level as follows: 


W 4 Warning 

E 8 Error 

S 12 Severe error 

U 16 Unrecoverable error 
DSNHOO3I S FILE 'DDNAME' PARAMETERS INCORRECT. 


Explanation: The file 'DDNAME' was found to have invalid or 
incorrect parameters, such as, logical record length. 


Co — — Internal DB2 Information ~_ | 
This message is issued by the following CSECT(s): DSNHIORT 


eee End of interna! DB2 Information id 


Severity: 12 (severe error) 
System Action: The precompiler is terminated. 


User Response: Correct the data set or library parameters. 


DSNHO004I S type COULD NOT BE FOUND 


Explanation: The precompiler could not find the indicated type 
of statement in the application program source. This message 
is only issued for HOST(COBOL) and HOST(COB2). The 'type' 
specified in the message is either DATA DIVISION, 
WORKING-STORAGE SECTION, or PROCEDURE DIVISION. This 
error can cause other errors. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNHLEXC 


Pere ee, End of Internal DB2 Information | 


Severity: 12 (severe error) 


User Response: Ensure that the host language statement in 
your application program is correct and that the statement is 
present within the proper margins. 


DSNHOOSI U FILE ddname NO MEMBER NAME SPECIFIED 


Explanation: The 'ddname' must refer to a partitioned data 
set, and the member name must be specified in the allocation. 
This helps to prevent accidental erasure of the DBRM library. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHMAIN 


ae End of internal DB2 Information eee 


Severity: 16 (unrecoverable error) 
System Action: The precompiler is terminated. 


User Response: Correct the JCL or TSO allocate command to 
specify a member name. 


DSNHOO6! U FILE ddname COULD NOT BE OPENED 


Explanation: The file specified in the message is required, but 
it could not be opened. 


| ’ Internal DB2 Information ~~ yl 
This message is issued by the following CSECT(s): DSNHMAIN 


Ue Be ces End of Internal DB2 Information Pa iet oe 


Severity: 16 (unrecoverable error) 
System Action: The precompiler is terminated. 
User Response: Ensure that the file is present in your JCL. 


System Programmer Response: Ensure that the SYSIN data is 
provided. Also ensure that SYSLIB is defined if the application 
program contains SQL INCLUDE statements. 
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DSNHO007! — DSNH0131 


DSNHOO7} = E LINE nnnn, COL cc ILLEGAL CHARACTER 


IGNORED: 'c' (X'hh') 


Explanation: The character specified in the message (as 'c') 
is not permitted. The hexadecimal representation for the char- 
acter is 'hh'. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHTOKR 


Regret End of Internal DB2 Information Seen 


Severity: 8 (error) 
System Action: The character is ignored. 


User Response: Correct the character. It may need to be 
within quotation marks or apostrophes. 


DSNHO08I S LINE nnnn, COL cc NESTED INCLUDE NOT SUP- 


PORTED 


Explanation: While processing an INCLUDE, another nested 
INCLUDE statement was encountered. 


| ; Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHLEX 


Ls End of Internal DB2 Information ____——_— 


Severity: 12 (severe error) 
System Action: The nested INCLUDE statement is ignored. 


User Response: Remove the nested INCLUDE statements; they 
are not allowed in an included file. The DB2 precompiler 
permits only one level of INCLUDE statements. 


DSNHO009! S LINE nnnn, COL cc MEMBER name COULD NOT 


BE INCLUDED 


Explanation: The member name specified in the message was 
not found or could not be read. 


| Internal DB2 Information ans 
This message is issued by the following CSECT(s): DSNHLEX 


eter toe eu End of tnternal DB2 Information ee ern 


Severity: 12 (severe error) 


System Action: Processing continues without the data from 
that member. 


User Response: Ensure that the member is in the library and 
that its name is spelled correctly. Check and correct any JCL 
errors. They are likely to cause other errors. Ensure that the 
data set and library parameters are correct. 


S LINE nnnn, COL cc UNTERMINATED STRING 
CONSTANT BEGINNING text 


DSNH0101! 


Explanation: The constant specified in the message (as 'text') 
is not terminated properly. 
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| Internal DB2 information eal 
This message is issued by the following CSECT(s): DSNHTOKR 


eee End of Internal DB2 Information oe | 


Severity: 12 (severe error) 


System Action: The string is treated as if it were terminated by 
the end of file. 


User Response: Terminate the string constant. Check for and 
correct any missing or extra quotation marks and apostrophes. 
These errors are likely to cause others. Some statements were 
probably missed because of missing or extra string delimiters. 


DSNHO11l = S LINE nnnn, COL cc UNTERMINATED COMMENT 


Explanation: A comment is not terminated properly. This 
message is only issued for HOST(PLI) and HOST(C). 


| internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNHTOKR 


a End of Internal DB2 Information ge eee Be 


Severity: 12 (severe error) 


System Action: The string is treated as if it were terminated by 
the end of file. 


User Response: Ensure that the comment terminator is typed 
properly and that it is within the specified margins. This error 
is likely to cause others. Some statements were probably 
missed because of the missing comment terminator. 


DSNH012I =W_LINE nnnn, COL cc INVALID CONTINUATION 


Explanation: The continuation does not follow the host lan- 
guage rules. 


Internal DB2 Information aie aaa: 


This message is issued by the following CSECT(s): DSNHTOKR 
ee ae teeters End of Internal DB2 Information eee casa 


Severity: 4 (warning) 


System Action: Processing continues. Additional errors may 
result. 


User Response: Follow the host language continuation rules 
and embedded SQL continuation rules. Check the margin 
option. This error is most common in assembler language in 
cases when a continuation begins before the continuation 
column (the continuation column is column 16 by default). 


DSNHO0131 SQL STATEMENT FOUND OTHER THAN IN THE 


FIRST PROGRAM (OR MAIN PROGRAM) 


Explanation: This message is for VS COBOL II only. If any SQL 
statement is found in the source after the first program ina 
BATCH COMPILE or the end of the main program of a nested 
program, this message will be issued. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHLEXC 


{ End of Internal DB2 Information ee | 


Severity: 12 (severe error) 
System Action: The precompiler is terminated. 


User Response: Move up SQL statement and corresponding 
host variable declaration to the main program or to the first 
program and resubmit the job. 


DSNHO0141 SQL STATEMENT IS FOUND IN AN INAPPRO- 


PRIATE PLACE 


Explanation: If any SQL statement is found in the COBOL 
DECLARATIVES section, this message will be issued. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHLEXC 


eee eee End of internal DB2 Information pe hee ogee 


Severity: 8 (error) 
System Action: Processing continues. 


User Response: Move the SQL statement out of the COBOL 
DECLARATIVES section and resubmit the job. 


DSNHO016I 


Explanation: The character or keyword specified in the 
message (as 'token') is required but missing. 


E LINE nnnn, COL cc token REQUIRED 


internal DB2 Information 
This message is issued by the following CSECT(s): DSNHPARS 


LS sEna of internal DB2 Information 


Severity: 8 (error) 


System Action: The token is assumed to be present in order to 
continue checking the statement syntax. 


User Response: Correct your SQL statement. Check if you 
skipped either this keyword or another keyword earlier in the 
SQL statement. The assumed token. is printed in the SYSTEM 
error message. This token may not be what you intended, even 
though it is the only symbol allowed in the clause at this point. 


DSNHO191 =W OPTION: INVALID OPTION option 


Explanation: The option specified in the message was 
requested, but it is not a precompiler option. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNHOPTS 


ate egos End of internal DB2 Information ener 


Severity: 4 (warning) 


DSNH0141 — DSNH023! 


System Action: The option is ignored. 


User Response: Check the valid precompiler options to deter- 
mine if your spelling is correct for this option. This problem 
may cause additional errors if the APOST, APOSTSQL, COMMA, 
HOST, MARGINS, QUOTESQL, or TWOPASS option is needed 
but not specified. The other options are either defaults or affect 
only the listing. The problem should be corrected, and the pre- 
compile should be run again. 


DSNH0211 W OPTION: SUBOPTION NOT PERMITTED WITH 


OPTION option 


Explanation: The option specified in the message cannot have 
suboptions, but one or more were specified. 


| Internal DB2 Information 4 
This message is issued by the following CSECT(s): DSNHOPTS 


ae ee End of internal DB2 Information ee 


Severity: 4 (warning) 
System Action: The suboptions are ignored. 


User Response: None required. However, the suboption 
should be removed. 


DSNHO022i W OPTION: UNMATCHED ')' TAKEN AS ',' 


Explanation: An unmatched ending parenthesis was found 
before the end of the option string. 


[ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHOPTS 


[| End of Internat DB2 Information __._——— 


Severity: 4 (warning) 
System Action: The parenthesis is assumed to be a comma. 


User Response: Balance the parentheses. 


DSNH0231 W OPTION: SUBOPTION MISSING FOR OPTION 


option 


Explanation: The specified option requires a suboption, but 
one was not provided. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHOPTS 


eft End of Internal DB2 Information eee: 


Severity: 4 (warning) 
System Action: The option is ignored. 


User Response: Provide a suboption or remove the option. 
This problem may cause additional errors if the HOST or 
MARGINS option is needed but not specified. The other options 
are either defaults or affect only the listing. The problem 
should be corrected, and the precompile should be run again. 
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DSNH024! — DSNH032I 


DSNHO024I W OPTION: SUBOPTION suboption INVALID FOR 


OPTION option 


Explanation: The suboption specified in the message is not 
allowed for the option specified. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHOPTS 


[End of Internal DB2 Information ____ 


Severity: 4 (warning) 
System Action: Usually, the entire option is ignored. 


User Response: Refer to the ‘options used' list in the precom- 
piler output fisting to see if the option has been used. Remove 
the suboption. 


DSNHO025I W OPTION: EXCESSIVE SUBOPTIONS FOR 


OPTION option 


Explanation: More suboptions than are allowed were given for 
the option specified in the message. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHOPTS 


a os End of Internal DB2 Information ee ee ed 


Severity: 4 (warning) 
System Action: The excess suboptions are ignored. 


User Response: Remove excess suboptions. 


DSNH026!1 W OPTION: INVALID MARGINS FOR HOST LAN- 


GUAGE 


Explanation: The host language does not permit the specified 
margins. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHOPTS 


(ee gee End of Internal DB2 Information ae eel | 


Severity: 4 (warning) 
System Action: The MARGINS option is ignored. 


User Response: Ensure that the source statements are within 

the proper margins and that the margins are specified cor- 

rectly. The margins for COBOL must be 8, 72. The margins for 
_ FORTRAN must be 1, 72. 


DSNHO29!1_~—s EE. LINE nnnn, COL cc INTO CLAUSE REQUIRED 


Explanation: SELECT statements embedded in an application 
program must have an INTO clause to denote where the results 
of the SELECT are to be placed. Dynamic SELECT statements 
do not permit the INTO clause. 
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| Internal DB2 Information 7 ac 
This message is issued by the following CSECT(s): DSNHAPLY 


oe ees End of Internal DB2 Information ieee oo 


Severity: 8 (error) 


System Action: The statement is replaced by host language 
statements that, if executed, set an error code in the SQLCA. 


User Response: Add the INTO clause to the SELECT statement, 
and precompile the application program again. 


DSNHO30I W LINE nnnn, COL cc STATEMENT CONTAINS 


WRONG NUMBER OF 'INTO' VARIABLES 


Explanation: The number of variables specified in an INTO 
clause is not the same as the number of select-list elements 
(taking into account expansion of host structures and '*' or 
'table.*' select entries according to the declarations supplied). 


Internal DB2 information 
This message is issued by the following CSECT(s): DSNHANAL 


(Agee eee? End of Internal DB2 Information sees | 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Ensure the included table declarations are 
correct. If the declarations are correct, this statement will 
cause an error when the application program is bound. If the 
declarations are incorrect, you can proceed, but the declara- 
tions should be corrected. Otherwise, you need to correct the 
SQL statement and precompile again. 


DSNH0311 W LINE nnnn, COL cc STATEMENT CREATES A 
COLUMN WITH NAME name1 WHICH DOES NOT 


MATCH DECLARED NAME name2 


Explanation: The column name specified in a CREATE state- 
ment ('name1' in the message) is not the same as the name of 
the corresponding column in the DECLARE TABLE statement 
('‘name2' in the message). 


| ~ Internal DB2 Information ~~~ | 
This message is issued by the following CSECT(s): DSNHANAL 


ee End of Internal DB2 Information Were eee | 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Ensure that the DECLARE TABLE matches the 
CREATE TABLE. You can use the cross-reference and source 
listings to help find the two statements. ‘ 


DSNH032I = W LINE nnnn, COL cc STATEMENT CREATES A 
COLUMN name WHOSE ATTRIBUTES DO NOT 


MATCH THE DECLARATION 


Explanation: The column 'name' is specified in a CREATE 
statement with a different data type or length than was specified 
for the corresponding column in the DECLARE TABLE state- 
ment. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHANAL 


Lo End of Internal 082 Information ____——_| 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Correct the DECLARE TABLE or CREATE 
TABLE statement. If the DECLARE TABLE statement is incor- 
rect, some warnings may also be incorrect or may not be gen- 
erated when needed. If the CREATE TABLE statement is 
incorrect, it must be corrected. 


DSNHO33I = W LINE nnnn, COL cc STATEMENT CREATES 
MORE OR LESS COLUMNS THAN WERE 


DECLARED 


Explanation: The number of columns specified in a CREATE 
statement is different from the number of columns specified in 
the DECLARE TABLE statement. 


| internal DB2 Information 1 
This message is issued by the following CSECT(s): DSNHANAL 


US ee he End of Internal DB2 Information ee alee ee 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Ensure that the DECLARE TABLE matches the 
CREATE TABLE. If the DECLARE TABLE statement is incorrect, 
some warnings may also be incorrect or may not be generated 
when needed. If the CREATE TABLE statement is incorrect, it 
must be corrected. 


DSNHO341 =9W LINE nnnn, COL cc STATEMENT INSERTS 


MORE OR LESS VALUES THAN THE NUMBER OF 
COLUMNS DECLARED 


Explanation: The number of values specified in an INSERT 
statement is different from the number of columns specified in 
the DECLARE TABLE statement for the receiving table. 


internal DB2 Information 
This message is issued by the following CSECT(s): DSNHANAL 


ae eed End of Interna! DB2 Information acs 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Insert the correct number of values. If the 
DECLARE TABLE statement is incorrect, this warning may also 
be incorrect. If the INSERT statement is incorrect, it must be 
corrected. 


DSNH0331 — DSNH042! 


DSNHO038!I = S LINE nnnn, COL cc PROGRAM OR SUBPRO- 


GRAM CONTAINS MORE THAN 32767 SQL STATE- 
MENTS 


Explanation: The number of SQL statements in a an applica- 
tion program or a FORTRAN subprogram is greater than 32767. 
The total number of statements in an application program to be 
precompiled must be tess than 32767 to permit statement 
numbers to have unique references. !n COBOL, the limit is 9999 
for the statement number field. 


r ~~ Internal DB2 Information ; | 


This message is issued by the following CSECT(s): DSNHSTMD, 
DSNHSTMF 


ete hoe End of Internal DB2 Information eee 


Severity: 12 (severe error) 
System Action: The precompiler terminates. 


User Response: Divide the application program or subprogram 
into smaller programs so that the maximum number of state- 
ments will not be exceeded. 


DSNHO391 S PRECOMPILER INTERNAL LIMIT EXCEEDED 


Explanation: A precompiler internal limit has been exceeded. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNHSTMB, 
DSNHSTMC, DSNHSTMD, DSNHSTMF, DSNHSTMP 


loa teas, End of internal DB2 Information bt | 


Severity: 12 (severe error) 
System Action: The precompiler terminates. 


User Response: If the SQL statement numbers exceed 32767, 
move the SQL statements forward in the application program. 


DSNH041! W OPTION: MISSING HOST OPTION 


Explanation: The host language was not specified in the 
OPTION field. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHOPTS 


| End of internal DB2 information = 


Severity: 4 (warning) 
System Action: HOST(COBOL) is assumed. 


User Response: Specify the host ianguage if it is not COBOL. 
It is probably best to specify the host language and remove all 
warnings. 


DSNH0421 W OPTION: option OPTION INVALID FOR HOST 


LANGUAGE 


Explanation: The option specified in the message is not valid. 
The QUOTE and COMMA options are not permitted with 
HOST(ASM), HOST(PLI), or HOST(C). The TWOPASS option is 
not permitted with HOST(COBOL). 
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DSNHO050! — DSNHO080! 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNHOPTS 


Pi ce ee End of Internal DB2 Information eee | 


Severity: 4 (warning) 
System Action: The specified option is ignored. 


User Response: Remove the invalid option, or correct the host 
specification. 


DSNHOSO! W WARNINGS HAVE BEEN SUPPRESSED DUE TO 


LACK OF TABLE DECLARATIONS 


Explanation: One or more warning messages have been sup- 
pressed, because no table declarations were found prior to the 
the first SQL statement that referenced a table or column. 





| Internal DB2 Information ; | 
This message is issued by the following CSECT(s): DSNHMAIN 


Ne eo End of Internal DB2 Information eee 


Severity: 4 (warning) 


System Action: Processing continues. Suppression is discon- 
tinued if a table declaration is found. 


. User Response: Insert (or INCLUDE) table declarations before 
they are referenced in order to permit table and column 
checking. 


DSNHO51! E LINE nnnn, COL cc sqitype name PREVIOUSLY 


DECLARED OR REFERENCED 


Explanation: The variable 'sqltype' is TABLE, CURSOR, or 
STATEMENT. The identifier 'name' has already been defined 
with the given 'sqitype'. The definition may have occurred 
implicitty. For example, 'name' may have been found in the 
FROM clause of a SELECT, causing it to be defined as a table. 


[ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHSQL 


——— End of internal DB2 Information sd 


Severity: 8 (error) 


System Action: The name is installed in the symbol table as a 
duplicate. 


User Response: Remove duplicate definitions, or correct the 
references. Avoid implicit definitions by inserting (or including) 
table declarations before they are.referenced. Check the 
number of passes used. Use the cross-reference and source 
listings to help resolve this type of error. 


DSNH052I E LINE nnnn, COL cc COLUMN name IS ALREADY 


DEFINED IN TABLE table-name 


Explanation: The specified name is already defined as a 
column in the table named 'table-name' that is specified in the 
message. The definition may have occurred implicitly. For 
example, 'table-name' may have been found in a select-list, 
causing 'name' to be defined as a column within 'table-name' 
if 'table-name' was not declared as a host variable. 
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Internal DB2 Information _—-- ea 
This message is issued by the following CSECT(s): DSNHSQL 


| earee eer End of Internal DB2 Information | 


Severity: 8 (error) 


System Action: The name is installed in the symbol table as a 
duplicate. 


User Response: Remove duplicate definitions, or correct the 
references. Avoid implicit definitions by inserting (or including) 
table declarations before they are referenced. 


DSNHOS53i1 W NO SQL STATEMENTS WERE FOUND 


Explanation: No SQL statements were found in the precompiler 
input file. An empty DBRM member has been written. 


Internal DB2 Information ~~ a 
This message is issued by the following CSECT(s): DSNHMAIN 


Coe ees End of Internal DB2 Information Ne ees 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: If you had embedded SQL statements in your 
application program and none were found, check to see if your 
column margins are properly defined for your application 
program. 


DSNHO60i_ _—E LINE nnnn, COL cc INVALID type SPECIFICA- 


TION: spec 


Explanation: The ‘type’ specified in the message is either 
SCALE or LENGTH. The 'spec' specified in the message is the 
given SCALE or LENGTH specification in an SQL declaration. 
Length and scale specifications must be unsigned integers. 
The scale specification, where permitted, cannot exceed the 
length. The length specification cannot be 0. 


| pe Internal DB2 Information 


This message is issued by the following CSECT(s): DSNHSQL, 
DSNHSM5, DSNHSM2A 


tenes End of Internal DB2 Information oe es 


Severity: 8 (error) 
System Action: Processing continues. 


User Response: Correct the length or scaling. 


DSNHOS80!I_~—sC EE’ LINE nnn, COL cc usage VARIABLE name |S 


NOT type TYPE 


Explanation: The 'usage' specified in the message is iNDI- 
CATOR or STRING. The 'type' specified is SMALLINT, 
VARCHAR, or CHARACTER. The data type of the variable 
"name' is not acceptable. All indicator variables must be small 
integers. PREPARE and EXECUTE strings must be variable 
character strings, except for FORTRAN, which requires char- 
acter type. 





“Internal DB2 Information — - | 


This message is issued by the following CSECT(s): DSNHSM1, 
DSNHSM2, DSNHSM3 


i ee End of Internal DB2 Information Bee oes 


Severity: 8 (error) 


System Action: ifthe containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Specify a host variable of the proper type. 


DSNHO081t DSNHO081! W LINE nnnn, COL cc STATEMENT 
DOES NOT CONFORM TO ANS SYNTAX 
STANDARD, COLUMN FUNCTION WITH DISTINCT 


AS ARITHMETIC OPERATION OPERAND. 


Explanation: When the precompiler option 'STDSQL(86)' is in 
effect, the SQL syntax is checked to see if it is conforming to the 
ANS level 86 standard. Since column function with distinct as 
an arithmetic-operation operand is not ANS level 86 standard, 
this warning message is issued. 


[pane eS internal DB2 Information Weep = yO 
This message is issued by the following CSECT(s): DSNHANAL 


a End of Internal DB2 Information eee eee 


Severity: 4 
System Action: Processing continues. 


User Response: Option to change or not to change the syntax 
to conform to the ANS syntax standard. 


Operator Response: None. 
System Programmer Response: None. 


Problem Determination: Check SQL statement. 


DSNHO84| = W LINE nnnn, COL cc UNACCEPTABLE SQL 


STATEMENT 


Explanation: The referenced SQL statement is not allowed in 
this situation, but it will not cause an error. The BEGIN 
DECLARE SECTION, END DECLARE SECTION, UPDATE STATIS- 
TICS, and CONNECT statements are flagged as not compatible. 
In STDSQL (86), INCLUDE SQLCA is not allowed. This message 
is printed as a warning to the programmer. The BEGIN 
DECLARE SECTION statement and END DECLARE SECTION 
statement will not be flagged as warnings if they are ina C 
application. 


c .- Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNHAPLY, 
DSNHSQL, DSNHLEXC 


ae ae End of Internal DB2 Information ofa ee 


Severity: 4 (warning) 


System Action: The BEGIN DECLARE SECTION statement and 
END DECLARE SECTION statement are ignored. The other 


DSNH081!l — DSNHO90I 


statements are replaced by host language statements that will, 
if executed, set a warning code in the SQLCA. 


User Response: Unless this application program will be used 
with both SQL/DS and DB2, remove the statement. 


DSNHO85I = W LINE nnnn, COL cc UNACCEPTABLE SQL 


KEYWORD IGNORED: keyword 


Exptanation: The SQL keyword specified in the message is not 
allowed by DB2, but it does not cause an error. This message 
is printed as a warning to the programmer. 


pe ———~_ Internal DB2 Information ~ ~ | 


This message is issued by the following CSECT(s): DSNHSM3, 
DSNHSM5 


ie sae End of Internal DB2 Information eset eeoeae sl 


Severity: 4 (warning) 
System Action: The keyword and its parameters are ignored. 


User Response: Uniess this application program is used with 
both SQL/DS and DB2, remove the keyword. 


DSNHO88I = W LINE nnnn, COL cc THIS STATEMENT WILL 


action AN ENTIRE TABLE 


Explanation: The 'action' specified in the message is either 
DELETE or UPDATE. The referenced SQL statement has no 
WHERE clause and will delete or update all rows of the speci- 
fied table. This message is printed as a warning to the pro- 
grammer. 


. oo Internal DB2 Information ce ene 
This message is issued by the following CSECT(s): DSNHSM1 


ieee oes End of Interna) DB2 Information Fasten Sl 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Be sure that you intend to delete or update all 
rows. , 


DSNHO0S0!1 = S LINE nnnn, COL cc HOST VARIABLE NOT PER- 


MITTED HERE: name 


Explanation: Host variable references are not permitted in this 
type of SQL statement. The 'name’ specified in the message is 
invalid. 


fi. = 2 o~ © internal DB2 Information i aaias | 
This message is issued by the following CSECT(s): DSNHSMUD 


be ee End of Internal DB2 Information Spence S| 


Severity: 12 (severe error) 


System Action: The statement is replaced by host language 
statements that will, if executed, set an error code in the 
SQLCA. 
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DSNH102! — DSNH1071 


User Response: Specify a literal or a column name rather than 
a host variable. The colon (:) indicates that the name that 
follows is a host variable. Remove it to specify a column name. 


DSNH102I ~—E LINE nnnn, COL cc LITERAL STRING BEGIN- 


NING string IS TOO LONG 


Explanation: The referenced character string literal (beginning 
with 'string' in the message) is too long. Only up to 254 char- 
acters or 124 graphic characters are permitted. 


[ — Internal DB2 Information 
This message is issued by the following CSECT(s): ODSNHLEX 


———aa End of Internal DB2 Information ee ed 


Severity: 8 (error) 


System Action: If the SQL statement containing the string is a 
declaration, it is discarded. If the SQL statement containing the 
string is executable, it is replaced by host language statements 
that will, if executed, set an error code in the SQLCA. 


User Response: Correct the string. If a shorter string is 
acceptable, reduce the length of the literal. If a long string is 
required, a host variable is required. 


DSNH1031 = LINE nnnn, COL cc INVALID NUMERIC LITERAL 


token 


Explanation: The token specified in the message was found. It 
begins with a digit, but it is not a valid integer, decimal, or float 
literal. identifiers cannot begin with a digit except for the 
WHENEVER statement with HOST(FORTRAN), and the identi- 
fiers in COBOL. 


? ~~ Internal DB2 Information ~— ie 
This message is issued by the following CSECT(s): ODSNHLEX 


ee End of Internal DB2 Information ees 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that wiil, if 
executed, set an error code in the SQLCA. 


User Response: Check the indicated token for validity. Use 
apostrophes or quotation marks if a character literal is desired. 
Remove the invalid character(s) if a number is desired. 


DSNH104! E LINE nnon, COL cc ILLEGAL SYMBOL token; 


VALID SYMBOLS ARE: token-list 


Explanation: A syntax error was detected at the specified 
token. As an aid to the programmer, a partial list of valid 
tokens is provided in the message. This list assumes that the 
statement is correct up to that point. The error may be earlier 
in the statement, but the syntax of the statement appears to be 
valid up to this point. Only as many tokens are listed as fit on 
the remainder of the print line. 
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| Internal DB2 Information aa a ae 


This message is issued by the following CSECT(s): 


DSNHLEX, DSNHPARS, DSNHSM1, 
DSNHSM2, DSNHSM3, DSNHSM4, 
DSNHSM5, DSNHSM6, DSNHSQL, 
DSNHSM2A 


a ee End of Internal DB2 Information | 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Check the SQL statement in the area of the 
token that was specified in the message. Correct the state- 
ment. The correction might be as simple as inserting a for- 
gotten comma or keyword. It could involve the order of clauses 
or the omission of quotation marks. If the error token is 
END-OF-STATEMENT, the SQL statement does not end with a 
valid clause. If necessary, refer to Chapter 5 of SQL Reference 
for correct syntax. 


OSNH1051- ~—sE LINE nnnn, column-cc, invalid string constants 


Explanation: Incorrect graphic or mixed data literals were 
found on line nnnn, column cc. 


Internal DB2 Information * : a4 
This message is issued by the following CSECT(s): DSNHTOKR 


ceo Li End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: The literal is ignored and the SQL statement 
containing the problem is discarded. 


User Response: Specify the correct format of literals. 


System Programmer Response: Check for a quote, an apos- 
trophe, shift-out (so) or shift-in (si) characters, G characters, or 
the number of characters within the literal. 


DSNH1071! E LINE nnnn, COL cc NAME name IS TOO LONG; 


MAXIMUM IS size CHARACTERS 


Explanation: Names for the following cannot contain more than 
18 characters (20 including SQL escape characters, if present): 


e SQL columns 
SQL tables 
SQL views 
SQL indexes 
SQL synonyms. 


The following cannot contain more than 8 characters: 


¢ Authorization IDs 

¢ tNCLUDE member names 

¢ Storage group names 

¢ Buffer pool names 

Field procedure names 

Database names 

Table space names 

Application plans 

Database request modules (DBRMs) 
Constraint names specified in CREATE or ALTER TABLE 
statements. 


Host variable names cannot contain more than 64 characters. 


Voiume serial numbers cannot contain more than 6 characters. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNHLEX DSNHSMUD = DSNHSM4 
DSNHSQL 


ee ae End of Interna! DB2 Information ae 


Severity: 8 (error) 


System Action: If the SQL statement containing the problem is 
a declaration, it is discarded. If the SQL statement containing 
the problem is executable, it is replaced by host language 
statements that will, if executed, set an error code in the 
SQLCA. 


User Response: Correct the name length. 


DSNH1091_ ~—E LINE nnnn, COL cc type CLAUSE NOT PER- 


MITTED 


Explanation: The 'type' specified in the message is INTO, 
ORDER BY, or FOR UPDATE. Embedded SELECT statements 
cannot include ORDER BY (because the result cannot be more 
than a single row), or FOR UPDATE OF (because position is not 
retained). SELECT clauses used in cursor declarations or sub- 
selects cannot have an INTO clause (because the INTO is on the 
FETCH statement). CREATE VIEW statements may not include 
any of the above clauses. The UNION operator is not allowed in 
an embedded SELECT. 


| en © Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNHAPLY, 
DSNHSM1, DSNHSM6 


[End of Internal DB2 Information ____——_ 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Remove the clause. You may need to use a 
cursor to perform the processing. The ORDER and FOR 
UPDATE clauses are accepted on the DECLARE CURSOR state- 
ment. The INTO clause is accepted on the FETCH statement. 


DSNH109! — DSNH1131 


DSNH110!) = E LINE nnnn, COL cc INVALID HEX LITERAL 


BEGINNING string 


Explanation: The referenced hexadecimal literal contains one 
or more characters that are not valid hexadecimal numbers. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNHLEX 


————— End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the literal. 


DSNH1121 = E LINE nnnn, COL cc VALUE EXPRESSION BEGIN- 


NING expression IS INVALID WITH THE KEYWORD 
‘DISTINCT ' 


Explanation: Expressions are not permitted to be mixed with 
DISTINCT. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHSM2A 


U4 eae eee End of Internal DB2 Information hon ee 2 


Severity: 8 (error) 


System Action: !f the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
abie, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the syntax. If necessary, refer to 
Chapter 5 of SQL Reference for the correct syntax. 


DSNH1131 = E LINE nnnn, COL cc INVALID CHARACTER 


FOUND IN NAME: name 


Explanation: Names of buffer pools, databases, plans, storage 
groups, and tables must contain only uppercase alphabetic or 
national characters and numerics. The first character must be 
alphabetic or national. 


| Internal DB2 Information Ss 74 
This message is issued by the following CSECT(s): DSNHSMUD. 


_———e End of internai DB2 Information _ 


Severity: 8 (error) 


System Action: if the containing SQL statement is a dectara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the name. 
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DSNH1151 — DSNH129I 


DSNH115!1 = E LINE nnnn, COL cc ILLEGAL USE OF COMPAR- 


ISON OPERATOR operator | 


Explanation: The syntax is not correct for this type of compar- 
ison. A simple comparison such as '>' must not be followed 
by a list of items. The ANY and ALL comparisons must precede 
a subselect, rather than an expression or a list of items. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHSM2 


{| End of Internal DB2 Information ee! 


Severity: 8 (error) 


System Action: if the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the syntax. If necessary, refer to 
Chapter 3 of SQL Reference for the correct syntax. 


DSNH1171 ~~ E LINE nnnn, COL cc STATEMENT INSERTS THE 


WRONG NUMBER OF VALUES 


Explanation: The number of entries in a value-list is not the 
same as the number of columns specified in an INSERT state- 
ment. 


[are re exe internal DB2 information i aan 
This message is issued by the following CSECT(s): DSNHANAL 


leet eeepc End of Internal DB2 Information ae 


Severity: 8 (error) 
System Action: Processing continues. 


User Response: Correct the syntax. If necessary, refer to 
Chapter 5 of SQL Reference for the correct syntax. 


DSNH1201 A WHERE CLAUSE OR SET CLAUSE INCLUDES A 
COLUMN FUNCTION OR A WHERE CLAUSE 
INCLUDES A REFERENCE TO COLUMN 
[column-name ] WHICH IS DERIVED FROM A 


COLUMN FUNCTION IN A VIEW DEFINITION 


Explanation: A WHERE clause or SET clause contains a 
column function, possibly as a result of a reference to a column 
that is derived from a column function in a view definition. A 
column function is allowed in a WHERE clause only if that 
clause appears within a subquery of a HAVING clause. 


| ~~ Internal DB2 Information a —— I 


This message is issued by the following CSECT(s): DSNHSM1, 
DSNHSM2A 


See ce End of Internal DB2 Information hte ees cell 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, itis discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 
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User Response: Correct the syntax. A subselect clause may 
be needed to produce the function result. If necessary, refer to 
Chapter 5 of SQL Reference for the correct syntax. 


DSNH1251 ~—_E LINE nnnn, COL cc INVALID ORDER BY 


COLUMN NUMBER: number 


Explanation: A column number (specified in the message) was 
specified that is either less than 1 or greater than the number of 
items in the select-list. 


a = = Internal DB2 Information — 
This message is issued by the following CSECT(s): DSNHSM2 


Lo End of Internal DB2 Information Be eneaos Fal 


Severity: 8 (error) 
System Action: The cursor declaration is discarded. 


User Response: Correct the column number. If necessary, 
refer to Chapter 5 of SQL Reference for the correct syntax. 


DSNH1261 ~—E LINE nnnn, COL cc ORDER BY CANNOT BE 


USED WITH A FOR UPDATE OF CLAUSE 


Explanation: The ORDER BY clause makes the cursor inca- 
pable of being updated. 


aia Internal DB2 Information “see tof 
This message is issued by the following CSECT(s): DSNHSM1 


 haaea eee End of internal DB2 Information Bese eed 


Severity: 8 (error) 
System Action: The cursor declaration is discarded. 


User Response: This is a DB2 restriction. You may have either 
an ordered cursor or a cursor that may be updated. You cannot 
specify both attributes for the same cursor. You may need to 
change your application logic. 


DSNH1291 ~—E LINE nnnn, COL cc TOO MANY TABLES SPECI- 


FIED IN SQL STATEMENT 


Explanation: in a subselect, there may be no more than 15 ref- 
erences to table names. 


————— 7 Internal DB2 Information fae ee 
This message is issued by the following CSECT(s): DSNHSMUT 


Pes eeentes tons End of Internal DB2 Information este totes Tl 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Reduce the number of table references in 
each subselect. Each reference to a single table counts sepa- 
rately. The count only applies to table/view references in the 
FROM list. Each view will only be counted one time. Refer to 
Chapter 5 of SQL Reference for the definition of a subselect. 


E LINE nnnn, STATEMENT WITH LIKE PREDICATE 
HAS INCOMPATIBLE DATA TYPES 


DSNH1311! 


Explanation: If the column name at the left of LIKE or NOT LIKE 
is of a character type, the expression at the right must be a 
character type. If the column name is a graphic type, the 
expression at the right must be a graphic type. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHANAL 


ee es End of Internal DB2 Information jane to 


Severity: 8 (error) 
System Action: The statement is ignored. 
User Response: Check the data type of every operand. 


System Programmer Response: Check the data type of every 
operand. 


DSNH1321 ~=E LINE nnnn, COL cc INVALID LIKE PREDICATE 


Explanation: The value following LIKE must be an alphanu- 
meric host variable or literal, graphic host variable or literal, or 
special character literal. The item to the left of the LIKE or NOT 
LIKE must be a column name. Expressions that are more © 
complex are not allowed. 


| Internal DB2 Information EE | 
This message is issued by the following CSECT(s): DSNHSM2 


We eeeaeeee tee End of internal DB2 Information ere 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the syntax. If necessary, refer to 
Chapter 3 of SQL Reference for the correct syntax. 


DSNH1701 THE NUMBER OF ARGUMENTS SPECIFIED FOR 


function-name 1S INVALID 


Explanation: An SQL statement has specified the scalar func- 
tion 'function-name' with either too many or too few argu- 
ments. 


| ex Internal DB2 Information ~ ee 
This message is issued by the following CSECT(s): DSNHSM2A 


eet End of Internal DB2 Information ee ee 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. if the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the function call. Refer to Chapter 4 
of SQL Reference for information about the number of argu- 
ments required by the scalar function 'function-name'. 


DSNH131! — DSNH184I 


DSNH1711 THE DATA TYPE, LENGTH, OR VALUE OF ARGU- 


MENT nn OF function-name IS INVALID 


Explanation: Either the data type, the length or the value of 
argument 'nn' of scalar function 'function-name' is incorrect. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHANL2 


[ee ees ess End of Internal DB2 Information cease 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the argument. Refer to Chapter 4 of 
SQL Reference for rules for each argument of the scalar func- 
tion 'function-name'. 


DSNH182I AN ARITHMETIC EXPRESSION WITH A DATETIME 


VALUE IS INVALID 


Explanation: The specified arithmetic expression contains an 
improperly used date/time value or labeled duration. 


[po PR Internal DB2 Information ee ee 
This message is issued by the following CSECT(s): DSNHANAL 


USee ee See End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. if the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the indicated expression. Refer to 
Chapter 3 of SQL Reference for the rules for date/time arith- 
metic. 


DSNH1841 AN ARITHMETIC EXPRESSION WITH A DATETIME 


VALUE CONTAINS A PARAMETER MARKER 


Explanation: The specified expression contains a parameter 
marker improperly used with a date/time vaiue. 


aaa Internal DB2 Information Sa eH 
This message is issued by the following CSECT(s): DSNHANAL 


ae End of Internal DB2 Information ae eereee 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the indicated expression. Refer to 
Chapter 3 of SQL Reference for information about date/time 
arithmetic. 
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DSNH1981 — DSNH206I 


DSNH1981 ~=E LINE nnnn, COL cc EMPTY SQL STATEMENT 


IGNORED 


Explanation: The referenced SQL statement has no text 
between the EXEC SQL and the statement terminator. 


| Internal DB2 Information Sree gy a ee 
This message is issued by the following CSECT(s): DSNHLEX 


WP omiateeeaea End of Internal DB2 information Ree eel 


Severity: 8 (error) 
System Action: The statement is ignored. 


User Response: Correct the statement, or remove it. 


DSNH1991 —E LINE nnnn,.COL cc INVALID KEYWORD keyword; 


VALID SYMBOLS ARE: token list 


Explanation: A syntax error was detected at the keyword spec- 
ified in the message. As an aid to the programmer, a partial list 
of valid tokens is provided in the message. This list assumes 
that the statement is correct up to that point. The error may be 
earlier in the statement, but the syntax of the statement 
appears to be valid up to this point. Only as many tokens are 
listed as will fit on the remainder of the print line. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNHLEXC, 
DSNHLEXD, DSNHPARS, DSNHSQL, DSNHSM1 


Wi ooh en Ze! End of Internal DB2 Information ee oe eee 


Severity: 8 (error) 


System Action: If the containing SQL statement is a deciara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Check the SQL statement in the area of the 
indicated keyword. Acolon or SQL delimiters may be missing. 
Correct the SQL statement. 


DSNH2031 W LINE nnnn, COL cc STATEMENT REFERENCES 


COLUMN column name, WHICH IS DECLARED IN 
MORE THAN ONE OF THE SPECIFIED TABLES 


Explanation: The column ‘column name’ was referenced 
without sufficient qualification. Type checking cannot be done. 


| Internal DB2 Information “sy 


This message is issued by the following CSECT(s): DSNHANAL, 
DSNHANL2 


nee End of Interna! DB2 Information a 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: /f the table declares are correct and the 
column name is not unique, this will create an error in the BIND 
step. Correct the DECLARE TABLE statement, or use the 
correct table name to qualify the column name. 
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DSNH2041 W LINE nnnn, COL cc STATEMENT REFERENCES 


UNDECLARED TABLE table-name 


Explanation: The table definition was not provided. It is 
optional, but checking cannot be done without the table infor- 
mation. (Bind will check against the actual table during later 
processing.) 


| — : Internal DB2 Information 


This message is issued by the following CSECT(s): DSNHANAL, 
DSNHANL2 


— End of Internal DB2 information oe 


Severity: 4 (warning) 
System Action: Processing continues. 


The table declarations permit more checking to be done. 


W LINE nnnn, COL cc COLUMN column-name WAS 
NOT DECLARED IN TABLE table-name 


DSNH2051 


Explanation: The column name 'column-name' is not con- 
tained in the table declarations. The name specified in a DIS- 
TINCT function must reference a column of the table. The value 
expression of an ALL function must reference a column of the 
table. 


| Internal DB2 Information ~ | 5 =i 
This message is issued by the following CSECT(s): DSNHANAL 


Peaster gs End of internal DB2 Information Seer 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: If the table declares are correct and the 
column name is not in the table, this will create an error in the 
BIND step. Correct the DECLARE TABLE statement or the 
column name. 


DSNH2061 W LINE nnnn, COL cc STATEMENT REFERENCES 
COLUMN column name WHICH IS NOT DECLARED 
IN THE SPECIFIED TABLE(S) 


Explanation: The column 'column name’ is not contained in 
any TABLE declaration for the tables specified in the statement. 


| internal DB2 Information | 


This message is issued by the following CSECT(s): DSNHANAL, 
DSNHANL2 


Ue ot eet End of Internal DB2 Information sep Satee 200-58 a 


Severity: 4 (warning) 

System Action: Processing continues. 

User Response: Ifthe table declares are correct and the 
cojumn name is not in the tables, this will create an error in the 


BIND step. Correct the DECLARE TABLE statements or the 
column name. 


System Programmer Response: Check the spelling of the 
column name. Ensure that all the tables needed were specified 
in the statement. 


DSNH2071 E LINE nnnn, COL cc ILLEGAL ORDER BY SPEC- 


IFICATION 


Explanation: If the select expression involves a UNION oper- 
ator, the 'ORDER BY' list must use numeric constants rather 
than variables. 


— ae ~ Internal DB2 Information <a al 
This message is issued by the following CSECT(s): DSNHSM1 


toed ee End of Internal DB2 Information ed 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, itis discarded. if the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the syntax. If necessary, refer to 
Chapter 5 of SQL Reference for the correct syntax. 


DSNH251{ S LINE nnnn, COL cc TOKEN name IS NOT VALID 


Explanation: The location name cannot contain alphabetic 
extenders for national languages (that is, #, @, and $ in the 
United States). 


| internal DB2 Information ae 
This message is issued by the following CSECT(s): DSNHSM2 


[eee ee End of Internal DB2 Information ee we ttl 


Severity: 8 (error) 
System Action: Processing continues. 


User Response: Correct the content of the location name. 


DSNH290! NO VALID 'END DECLARE SECTION' FOUND 


Explanation: The user’s source program contains a BEGIN 
DECLARE SECTION but no corresponding END DECLARE 
SECTION was found. 


| Internal DB2 Information ~~ 
This message is issued by the following CSECT(s): DSNHLEXD 


Powe End of Internal DB2 Information one 5 


Severity: 8 (error) 
System Action: Processing continues. 


User Response: Check the application program and ensure 
that a valid END DECLARE SECTION statement is present. 


DSNH2911 NO VALID 'BEGIN DECLARE SECTION' FOUND 


Explanation: The user’s source program contains an END 
DECLARE SECTION but no corresponding BEGIN DECLARE 
SECTION was found. 


DSNH207! — DSNH312I 


| internal DB2 Information aoe “al 
This message is issued by the following CSECT(s): DSNHLEXD 


ee End of internal DB2 Information aaa ae 


Severity: 8 (error) 
System Action: Processing continues. 


User Response: Check the application program and ensure 
that a valid BEGIN DECLARE SECTION is present. 


DSNH303! =9W LINE nnnn, COL cc STATEMENT SELECTS 


INCOMPATIBLE DATA TYPE INTO hostvar 


Explanation: The data type of host variable 'hostvar' is not 
compatible with the apparent type of the corresponding select 
expression. One of them is numeric, while the other is char- 
acter, or one of them is character, while the other is graphic. If 
the select expression is a column reference, the data type is 
obtained from its declaration. 


| internal DB2 Information = “| 
This message is issued by the following CSECT(s): DSNHANAL 


re End of internal DB2 Information opr eae ee xe 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Ensure that the table definitions are current 
and that the host variable has the proper data type. 


System Programmer Response: Ensure that the table defi- 
nitions are current, and that the host variable has the proper 
data type. 


DSNH312i ~—s EE LINE nnnn, COL cc UNDEFINED OR UNUSABLE 


HOST VARIABLE name 


Explanation: The 'name' in the message is used in an SQL 
statement, but either no declaration was found in the applica- 
tion program (so far), or the attributes are improper for this 
use. Declarations for host variables used in a DECLARE 
CURSOR statement must precede the SQL statement, regard- 
less of the ONEPASS or TWOPASS option for the precompiler, 
or a parameter marker was expected in an EXECUTE IMME- 
DIATE statement. 


| internal DB2 Information ae 
This message is issued by the following CSECT(s): DSNHSMUD 


Reet cee End of Internal DB2 Information er rar: 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. {f the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Check the declaration and the attributes of the 
named host variable. If you intended the name to refer to a 
column, the colon (:) should not be present. If you intended a 
literal, you need to enclose the value in string delimiters (apos- 
trophes or quotation marks). 
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DSNH3141 — DSNH405I 


lf you intended to use a host variable, only a subset of the pos- 
sible variable declarations are valid for use as a DB2 host vari- 
able. The rules for host variables are listed in the application 

programming guides. Use the cross-reference listing and pre- 
compiler source listing to determine the source of the problem. 


¢ If the cross-reference listing does not contain the host vari- 
able name, the declaration is missing. If the source for a 
declaration is present, a missing terminator from a 
comment or from a string may cause this type of error. The 
margins could also cause this type of error. 

¢ Ifthe name is present, but the data type is not listed, the 
host variable is not usable; it does not follow the rules out- 
lined for valid host variable definitions. 

e If several definitions exist for the name, the first reference 
may occur before the definition. The use of the TWOPASS 
option helps by processing DECLARE statements before the 
other types of statements. However, host variable declara- 
tions and cursor declarations are processed in the same 
pass. The host variables referenced in cursor declarations 
must be defined before the cursor is defined in the applica- 
tion program. 

* A parameter marker is expected rather than a host variable 
in an EXECUTE IMMEDIATE statement. 


DSNH3141 ~=E LINE nnnn, COL cc REFERENCE TO HOST VARI- 


ABLE name AMBIGUOUS 


Explanation: The host variable 'name' has been defined more 
than once in this application program. The precompiler cannot 
distinguish which host variable definition should be used here. 
The following table indicates some possible combinations. DB2 
supports only a single adjacent qualifier for a host variable 
name. 


Suggested 

Case Ref Definition Result Change 

1 a xX.a Valid None 

2 Xa X.a, y.a Valid None 

3 a X.a, y.a DSNH3141 Reference x.a or 
y.a 

4 a X.a,a Valid None 

5 xa q.x.a, DSNH3141 Variable name 

V.X.a changes 
6 a a,a DSNH314I Variable name 


changes 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHSMUD 


[Pesta oe End of Internal DB2 Information pits Te dS) 


Severity: 8 (error) 


System Action: If the SQL statement is a declaration, it is dis- 
carded. If the containing SQL statement is executable, it is 
replaced by host language statements that will, if executed, set 
an error code in the SQLCA. 


User Response: Make the host variable name unique or use 
qualification to indicate which host variable definition is to be 
used, as suggested in the above table. 


DSNH4011 = W LINE nnnn, COL cc STATEMENT SPECIFIES 
INCOMPATIBLE OPERANDS FOR COMPARISON 


OPERATOR name 


Explanation: The comparison operation 'name' is used witha 
mixture of incompatible data type operands. 
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Pee Internal DB2 Information Sl 
This message is issued by the following CSECT(s): DSNHANAL 


a End of internal DB2 Information Be Eee 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Make both operands compatible character 
data types. Ensure that the table declaration is correct. 


DSNH402i = W LINE nnnn, COL cc STATEMENT APPLIES name 


TO CHARACTER DATA 


Explanation: The numeric operation or function 'name' is 
used with a nonnumeric operand. 


eae Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNHANAL, 
DSNHANL2 


eee End of Internal DB2 Information | 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Make the operand numeric or use a character 
function. Ensure that the table declaration is correct. 


DSNH4041 ~=—W LINE nnnn, COL cc STATEMENT INSERTS OR 


UPDATES COLUMN name WITH VALUE THAT IS 
TOO LONG 


Explanation: An INSERT or UPDATE statement specifies a 
vaiue that is longer than the maximum-length string that can be 
stored in that column, according to the DECLARE TABLE state- 
ment. 


ea Internal DB2 Information Sm ae ty 
This message is issued by the following CSECT(s): DSNHANAL 


ae End of Internal DB2 Information es 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Ensure that the length is allowed and that the 
table declaration is correct. 


DSNH4051 ~—s E LINE nnnn, COL cc LITERAL number IS OUT OF 


RANGE 
Explanation: The number is not in the proper range: 


e +5.4E—79 to 7.2E+75 for floating point 
e —g9ggg99999999999 to 999999999999999 for packed decimal 
© ~2147483648 to 2147483647 for integers 


| internal DB2 information | 
This message is issued by the following CSECT(s): DSNHLEX 


| seEnd of Internal DB2 Information 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. lf the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the number. 


DSNH408I =o W LINE nnnn, COL cc STATEMENT INSERTS OR 
UPDATES COLUMN name WITH INCOMPATIBLE 


DATA TYPE 


Explanation: The data type of the value to be inserted into 
column ‘name’ by an INSERT or UPDATE statement is incom- 
patible with the declared data type of the column. Both must be 
numeric or both must be character. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHANAL 


re End of Internal DB2 Information Be eeasiee el 


Severity: 4 (warning) 
System Action: Processing continues. 


Programmer Response: Be sure that the table definitions are 
current, and that host variables and literals have the proper 
data types and are matched. 


DSNH4141 THE NUMERIC OR DATETIME COLUMN column- 


name IS SPECIFIED IN A LIKE PREDICATE 


Explanation: A column ('column-name') with a numeric data 
type was specified in a LIKE predicate. Columns specified in a 
LIKE predicate must be character or graphic string columns. 


ee Internal DB2 Information , oe 
This message is issued by the following CSECT(s): DSNHANAL 


re ar End of internal DB2 Information _ 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct the statement. 


DSNH5041 E LINE nnnn, COL cc CURSOR name WAS NOT 


DECLARED 


Explanation: identifier 'name' is used as a cursor, but has not 
been declared. The declaration may have been discarded 
because of errors. 


DSNH408I — DSNH557! 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHSMUD 


es End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Correct or add the required cursor declara- 
tion. 


DSNHS506I EE LINE nnnn, COL cc DECLARE CURSOR FOR 
STATEMENT NAME MUST PRECEDE THE 
PREPARE STATEMENT FOR THAT STATEMENT 


NAME 


Explanation: This DECLARE 'name' CURSOR statement is 
preceded by a PREPARE 'name' statement. In DB2, declara- 
tions must precede action statements. This is not the same as 
in SQL/DS. 


aie internal DB2 Information Se) 
This message is issued by the following CSECT(s): DSNHSMUD 


ed End of interna! DB2 Information types 


Severity: 8 (error) 


System Action: The declaration is noted as being in error and 
discarded. 


User Response: Move the DECLARE or PREPARE statement so 
that they are in the proper order, or specify the TWOPASS 
option if the host language is PLI, ASM, or C. The TWOPASS 
option has the precompiler check for declarations on the first 
pass and avoids this problem. 


DSNH5571_ ~—E LINE nnnn, COL cc INCONSISTENT 
GRANT/REVOKE KEYWORD keyword; PERMITTED 


KEYWORDS ARE keyword list 


Explanation: The 'keyword' specified in the message is the 
encountered keyword. The 'keyword list' specified in the 
message is a list of the keywords that are permitted in this 
context. The mixture of privileges requested on a GRANT or 
REVOKE statement is not aliowed. The authorities must all be 
of one type and consistent with the form of GRANT or REVOKE. 
REVOKE UPDATE (column list) is not allowed; only REVOKE 
UPDATE is permitted. 


tr - Internal DB2 Information ee, 
This message is issued by the following CSECT(s): DSNHSM3 


ee ee End of Internal DB2 Information ee 


Severity: 8 (error) 


System Action: The containing SQL statement is replaced by 
host language statements that will, if executed, set an error 
code in the SQLCA. 


User Response: Correct the syntax. If necessary, refer to 
Chapter 5 of SQL Reference for the correct syntax. 
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DSNH558! — DSNH740I 


DSNH558I_ ~— EE LINE nnnn, COL ccc INVALID CLAUSE OR COM- 


BINATION OF CLAUSE ON A GRANT OR REVOKE 


Explanation: “PUBLIC AT ALL LOCATIONS’ is invalid for non- 
table privilege GRANT or REVOKE statements. It is also invalid 
for table privilege GRANT or REVOKE statements that specify 
the ALTER or INDEX privilege. 


To Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNHSM3 


——————— End of Internal DB2 Information ee 


Severity: 8 (error) 
System Action: The statement cannot be executed. 


User Response: Refer to Chapter 3 of SQL Reference for valid 
keywords for the GRANT or REVOKE statement. 


DSNH637!1 ~— E LINE nnnn, COL cc DUPLICATE keyword 


KEYWORD 


Explanation: A duplicate specification for 'keyword' was found 
while processing the statement. 


| Internal DB2 Information ~ “= 7 al 


This message is issued by the following CSECT(s): DSNHSM3, 
DSNHSM4, DSNHSM5, DSNHSM6, DSNHSM8 © 


[ek es os End of Internal DB2 Information ees 


Severity: 8 (error) 


System Action: If the containing SQL statement is a declara- 
tion, it is discarded. If the containing SQL statement is execut- 
able, it is replaced by host language statements that will, if 
executed, set an error code in the SQLCA. 


User Response: Remove the duplicate specification. 


DSNH6441 ~=INVALID VALUE SPECIFIED FOR KEYWORD 


keyword IN stmt-type STATEMENT 


Explanation: The value specified for the 'keyword' parameter 
in the 'stmt-type' SQL statement is not a permitted value. 


| Internal DB2 Information ” 


This message is issued by the following CSECT(s): DSNHSM4, 
DSNHSM5, DSNHSM6, DSNHSM8 


UP as ee oe End of Internal DB2 Information wee daa 


Severity: 8 (error) 


System Action: !f the SQL statement containing the problem is 
a declaration, it is discarded. If the SQL statement containing 
the problem is executable, it is replaced by host language 
statements that will, if executed, set an error code in the 
SQLCA. 


User Response: Correct the statement. Refer to Chapter 5 of 
SQL Reference for information about the allowable values for 
the 'keyword' in the 'stmt-type’ statement. 
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DSNH684I~—s E LINE nnnn, COL cc LITERAL LIST BEGINNING 


string IS TOO LONG 


Explanation: The length of the literal list beginning with 
'string', excluding insignificant blanks and delimiting paren- 
thesis, is greater than 254. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNHSM2, 
DSNHSM2A 


a End of Internal DB2 Information eet 


Severity: 8 (error) 


System Action: The SQL statement could not be executed. 


System Programmer Response: Correct the SQL statement. 
Refer to Chapter 3 of SQL Reference for information about 
writing literal lists. 


DSNH740I xxxxxx phase FINISHED, RC = retcode, LISTING 


IN data-set 


Explanation: The DSNH INST phase completed with return 
code 'retcode'. The 'phase' will be one of the following: 


PLI Macro Pass 

Precompiler 

CICS Command Translator 

Bind 

Compile/assembly 

PLI 

Prelink (unique to C/370 Compiler) 
Link 

Run. 


If the CLIST puts the listing into a data set, the name of the data 
set is shown as 'data-set'. If the PRINT parameter is LEAVE, 
NONE, or TERM, the 'LISTING IN data-set’ portion of this 
message is omitted. 


Refer to message DSNH756I for an explanation of the print data 
set names assigned during processing. 


| ~ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNH 


End of internal DB2 Information Gres | 


Severity: 'retcode' 


System Action: Processing continues as requested. 


User Response: This phase is complete. If there are errors, 
other messages are produced. The next phase requested will 
begin. The order of the phases is: 


1. PL! Macro Pass 

2. Precompiler 

. CICS Command Translator 

. Bind 

. ASM, ASMH, C (C/370 Compiler), COBOL, COBOL2, 
FORTRAN, PLI 

6. Prelink 

7. Link 

8. Run. 


af © 


OSNH741I ~=—s process1(NO) IMPLIES THAT process2 CANNOT 


BE RUN 


Explanation: An inconsistent set of processing was specified. 
An earlier phase and a later phase were requested, but not the 
intermediate step needed to process data between them. For 
example, requesting the precompile and the link edit, without 
the compile will produce this error. Values for 'process1' can 
be PRECOMP, CICSXLAT, COMPILE, LINK, or BIND. Values for 
'process2' can be COMPILE, LINK, or RUN. 


| Interna! DB2 Information 
This message is issued by the DSNH CLIST. 


Ree End of Internal DB2 Information eae | 


Severity: 4 (warning) 


System Action: 'process2' is not performed, but other proc- 
essing will be done. 


User Response: Specify a consistent combination of proc- 
essing. Application program preparation needs to run all the 
steps to provide a correct application program. The process 
does allow beginning or ending steps to be run at a different 
time. See message DSNH740I for the required step order. 


DSNH751I_ _—clist ERROR IN type VALUE value 


Explanation: The CLIST keyword 'type' does not have an 
acceptable value. 


The possible keyword types for DSNH include: 


ACQUIRE ISOLATION RUN 
ACTION LINK SOURCE 
BIND MACRO SPACEUN 
COMPILE OPTIONS SQLDELIM 
CONTROL PASS STDSQL 
DECIMAL PRECOMP SUFFIX 
DELIMIT PRELINK VALIDATE 
FLAG RELEASE XREF 
HOST RETAIN 


The possible keyword types for DSNHC include: 


ATTACH FLAG SPACEUN 
CONTROL HOST XREF 
DELIMIT SOURCE 


‘value' is the value listed in the CLIST. Note that the CLIST 
checks only one character of the value. 


oo. ~ Internal DB2 information 


This message is issued by the following CSECT(s): DSNH, 
DSNHC 


es? End of Internal DB2 Information gts ae acd | 


' Severity: 8 (error) 


System Action: The CLIST terminates. 


User Response: Refer to Chapter 2 of Command and Utility 
Reference for the keywords and their permitted values. Correct 
the input request. 


DSNH7411l — DSNH7551 


DSNH7521 INPUT DATA SET NAME IS MISSING OR NONE 


Explanation: The DSNH CLIST requires a value for the input 
data set name (INPUT). You cannot use an input data set name 
of NONE. 


Severity: 0 (successful) 


System Action: The CLIST prompts for a name, if prompting is 
allowed. If prompting is not allowed, for example in batch or 
when PROFILE NOPROMPT was entered, the CLIST terminates. 


i. ©- 3 internal DB2 information =o 
This message is issued by the DSNH CLIST. 


Le End of Internal DB2 Information ites 


User Response: Specify an INPUT name. See message 
DSNH7531. 


DSNH753!1 ENTER INPUT DATA SET NAME 


Explanation: The CLIST is requesting the name of the input 
data set. 


internal DB2 Information | 
This message is issued by the DSNH CLIST. 


a End of Internal DB2 Information ee 


Severity: 0 (successful) 


System Action: Waits for user to enter data set name or for the 
CLIST to be terminated. 


User Response: Enter the name of the data set. Do not specify 
the parameter or command, but just enter the name of the data 
set. The standard TSO prefixing will be done if the data set 
name is not entered in apostrophes. 


DSNH754!_ ~—s clist OUTNAME PARAMETER name MUST NOT 


CONTAIN SPECIAL CHARACTERS 


Explanation: The DSNH and DSNHC CLISTs, 'clist', use the 
OUTNAME parameter to build names for a number of data sets 
that are passed from phase to phase. These names will be pre- 
fixed by an authorization ID or TSO prefix value and have a 
number of suffixes. For this reason, OUTNAME 'name' must 
not contain special characters. It may contain a period or 
national characters. It cannot have apostrophes to specify a 
single data set name. 


Severity: 8 (error) 
System Action: The CLIST is terminated. 


User Response: Correct the input request. The default for this 
parameter is TEMP, which should be adequate for most usage. 


DSNH7551 OUTNAME PARAMETER name MUST NOT BEGIN 


THE SAME. AS INPUT input 


Explanation: The DSNH CLIST uses the OUTNAME parameter 
‘name’ to build a number of data sets that are passed from 
phase to phase. These daia sets could conflict with the INPUT 
data set, 'input', if the names are the same causing the INPUT 
data set to be overwritten. To avoid this potential problem, the 
names are not allowed to have the same initial characters. 
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DSNH756I — DSNH759I 


| Internal DB2 Information — | 
This message is issued by the DSNH CLIST. 


ge oes End of Internal DB2 Information a | 


Severity: 8 (error) 
System Action: The CLIST is terminated. 


User Response: Correct the input request. Specify a different 
OUTNAME. The default for OUTNAME is TEMP. 


DSNH756!__—clist PRINT PARAMETER name MUST NOT 


CONTAIN SPECIAL CHARACTERS 


Explanation: The DSNH and DSNHC CLISTs, 'clist', use the 
PRINT parameter to build names for data sets used for the print 
listings from various phases. These names are prefixed by an 
authorization ID or a TSO prefix value and have a number of 
suffixes. The PRINT parameter 'name' can contain a period or 
national characters, but it cannot contain special characters. It 
cannot have apostrophes to specify a single data set name. 


The data set names built using the PRINT(print) qualifier are the 
following: 


print.CXLIST CICS Command Translator 
print. LINKLIST Linkage Editor 

print.LIST Compiler or Assembler 
print.PCLIST DB2 Precompiler 


print. SYSCPRT.LIST 
print SYSOUT.PRELLIST 


C/370 Compiler 
C/370 Prelink Utility 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNH, 
DSNHC 


ee ee End of Internal DB2 Information i ee 


Severity: 8 (error) 
System Action: The CLIST terminates. 


User Response: Correct the 'name' specified with the PRINT 
parameter. 


DSNH7571 ERROR IN PLAN NAME LENGTH value 


Explanation: ‘value’ is too long for a plan name. A plan name 
has a maximum of 8 characters. 


[ 7 Internal DB2 Information ; | 
This message is issued by the DSNH CLIST. 


ae ee End of Internal DB2 Information hace 


Severity: 8 (error) 
System Action: The CLIST is terminated. 


User Response: Specify a plan name with 8 or fewer charac- 
ters. 
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DSNH758I HOST(host-language) IS NOT PERMITTED WITH 


RUN(IMS) OR RUN(CICS) 


Explanation: There is no facility for connecting a FORTRAN 
program to either IMS/VS or CICS, and no facility for connecting 
a C (C/370 Compiler) program to CICS. 


| Internal DB2 Information y ve 
This message is issued by the following CSECT(s): DSNH 


eae tae =e End of Internal DB2 Information So ee es) 


Severity: 8 (error) 
System Action: The CLIST terminates. 


User Response: Use the specified language in the TSO or 
batch environment. 


DSNH7591 __—clist TERMINATING, phase RC = retcode 


Explanation: The DSNH or DSNHC 'clist' terminated at 
'phase' because the return code 'retcode' was greater than or 
equal to the RCTERM parameter value. 


The 'phase' will be one of the foliowing: 


ASM ASMH 

BIND CICS Command Translator 
COBOL COB2 

CLIST CHECKING FORTRAN 

PLI C (C/370 Compiler) 

Prelink Link 

PLI Macro Pass Precompiler 

Run 


| : ~~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNH, 
DSNHC 


Vis tees Se End of Internal DB2 Information oe ee 


Severity: ‘retcode' 


System Action: The CLIST terminates. 


User Response: Determine the cause for the high return code. 
If the parameters include TERM(NONE) and direct the PRINT to 
a data set, you might need to search the print data sets for the 
listing of the error. Refer to message DSNH756I for an explana- 
tion of the print data set names assigned during processing. 


Problem Determination: The location of the messages 
describing the prior errors depends upon the values of the 
TERM and PRINT parameters. The messages can be directed 
to the terminal, to preallocated data sets, or to data sets 
dynamically allocated during CLIST processing. 


If TERM(NONE) PRINT(NONE) was specified, the messages are 
not available. Execute the CLIST again and specify a location 
for the error messages. 


To find the documentation, note the immediately preceding 
DSNH740i message for the location of the listings. If the 
"LISTING IN data-set' portion of the message is missing, 
specify a PRINT data set, SOURCE(YES) and XREF(YES), and 
execute the CLIST again. Use TERM(TERM) to direct error 
messages to your terminal. These listings and execution of the 
DSNH CLIST are required for problem diagnosis. 





if the error is in the CLIST or the error location is CLIST 
CHECKING, use CONTROL(SYMLIST) to produce a detailed 
trace of the CLIST execution and provide the trace listing. 


Check for DSNH7511 messages that describe the error. 


DSNH7601 PRELINK OPTION INVALID WITH HOST LAN- 


GUAGE (host-language) 


Explanation: Invocation of the PRELINK step is not supported 
by 'host-language.' This option is valid only with C language 
(C/370 Compiler). 


ae — Internal DB2 Information ~~ 
This message is issued by the following CSECT(s): DSNH 


eee End of Internal DB2 Information _ 


Severity: 8 (error) 
System Action: The CLIST terminates. 


User Response: Refer to the DSNH PRELINK keyword option 
for a description of this function in Chapter 2 of Command and 
Utility Reference. 


DSNHS01I ~=—s«U LINE nnnn, COL cc INTERNAL PRECOMPILER 


ERROR — REASON CODE ccc 


Explanation: An internal compiler consistency check failed. 
Reason codes are: 


000 Message formatter called with unlisted internal 
message number 

001 Parser received a token code of 0 from lexical scan. 
Lexical scan refers to a scan of words rather than 
syntax. 

002 Error in storage suballocation control blocks. 

003 Error in storage suballocation request. 

004 Error in pointer structures. 

005 On BIND or REBIND, a host variable could not be 

; found. 
006 Unexpected value for parser option. 


ie — Interna! DB2 Information | 


This message is issued by the following CSECT(s): 


DSNHCORE DSNHDBRM ~~ DSNHLIST 
DSNHMAIN DSNHPARS DSNHSMUD 
DSNHSMUT DSNHTEXL DSNHXLTR 


eee End of Internal DB2 Information sd 


Severity: 16 (unrecoverable error) 
System Action: The precompiler is terminated immediately. 
User Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: A copy of the application program 
source and the printout is useful (specify SOURCE and XREF). 


DSNH9041 U STORAGE OVERFLOW 


Explanation: More storage is needed, but could not be 
obtained during precompiler execution. 


DSNH760! — DSNH904I 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNHCORE 


| End of internal DB2 Information ___———_| 


Severity: 16 (unrecoverable error) 
System Action: The precompiler is terminated immediately. 


System Programmer Response: The storage required for the 
current statement could not be acquired or exceeds the 
maximum (64K bytes) for a single request. If the region size is 
being used completely, check whether the region can be 
expanded. If it cannot be expanded, the SQL statement is too 
large to be processed. 
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DSNI001i — DSNI004I 





Data Manager Messages (DSNI...) 


DSNIO011 RESTART HAS BEEN DEFERRED REASON reason 


TYPE type NAME name 


Explanation: The resource identified by TYPE and NAME could 
not be restarted during restart. Consequently, it was stopped 
by DB2, and its restart was deferred. REASON contains the 
reason code explaining why the restart could not be performed. 


TYPE and NAME identify the resource for which restart has 
been deferred. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. 


| po ae Internal DB2 Information Ste eg 
This message is issued by the following CSECT(s): DSNIIMPD 


eee a Sieg End of Internal DB2 Information Be all 


System Action: DB2 restart continues. The resource is 
‘stopped' by DB2. Restart of the resource is deferred. 


User Response: Correct the problem indicated by REASON 
code, and then 'start' the resource. 


DSNIO002I csect-name UNABLE TO START OBJECT TYPE 
object-type OBJECT NAME object-name REASON 


reason TYPE type NAME name 


Explanation: The resource identified could not be started, 
because it was unavailable. The resource that was not started 
could be a database, a table space, or an index space. 
‘object-type' identifies the type. 'object-name' identifies the 
name. If the DB2 catalog is unavailable, 'object-type' will 
contain binary zeros and 'object-name' will contain blanks. 


The resource that was unavailable is identified by 'type' and 
'‘name'. The 'type' code identifies the type of the resource as 
well as the format and content of the 'name'. '‘reason' con- 
tains the reason code explaining why the resource was unavail- 
able. 


Refer to Figure 4 in Appendix B, “Problem Determination” on 
page X-5 for an explanation of resource type codes. 


—-_ -. Internal DB2 Information 


This message is issued by the following CSECT(s): DSNILSTS, 
DSNIDEFR, DSNICLST, DSNIBPDA 


Nee End of Interna! DB2 Information ey 


The variable 'csect-name' is the name of the CSECT issuing 
the message. 


System Action: The specified database or space is not started 
and remains in the current stopped state. If there are other 
databases or spaces to be started, they are processed 
normally. 


User Response: Correct the resource unavailable problem and 
reissue the -START command. 


DSNI003! csect-name UNABLE TO STOP OBJECT TYPE 
object-type OBJECT NAME object-name REASON 


reason TYPE type NAME name 


Explanation: The object identified could not be stopped, 
because a resource required to perform the stop was unavail- 
able. The object that was not stopped could be a database, a 
table space, or an index space. ‘object-type' identifies the 
type (refer to the TYPE code on the chart below); 'object-name' 
identifies the name. If the DB2 catalog is unavailable, 
‘object-type' will contain binary zeros and ‘object-name' will 
contain blanks. 


The resource that was unavailable is identified by 'type' and 
‘name'. The 'type' code identifies the type of the resource as 
well as the format and content of the resource, 'name'. 
‘reason' contains the reason code explaining why the resource 
was unavailable. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. 


Internal DB2 information | 
This message is issued by the following CSECT(s): DSNILSTS 


eastern End of internal DB2 Information fo fee Fn 2 ol) 


The variable 'csect-name' is the name of the CSECT issuing 
the message. 


System Action: The specified database or space is not stopped 
and will remain in the current state. If there are other data- 
bases or spaces to be stopped, they will be processed 
normally. 


User Response: Correct the resource unavailable problem and 
reissue the -STOP command. 


DSNI004I RESOURCE HAS BEEN STOPPED TYPE type 


NAME name 


Explanation: The resource identified by TYPE and NAME could 
not be opened/closed or was found to be in an inconsistent 
state. The resource has been 'stopped' by DB2. If an open 
error occurred during DB2 startup, restart processing for the 
resource was deferred. 


TYPE and NAME identify the resource that has been stopped. 
The TYPE code identifies the type of the resource as well as the 
format and content of the resource, NAME. 


Type codes '00000200' and '00000201' apply to this message. 
Refer to the Figure 4 in Appendix B, “Problem Determination” 
on page X-5 for an explanation of resource type codes. 


| ~~ Internal DB2 Information = ] 
This message is issued by the following CSECT(s): DSNISDBA 


eet End of Internal DB2 Information eee 


System Action: The table space or index space is stopped by 
DB2. 


User Response: Previous messages provide information to 
atlow you to determine the cause of the problem and the 
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method of correcting it. Refer to them, and correct the page set 
open problem. Then restart the page set, using the -START 
command, and invoke the application again. 


DSNIOO6I DEFERRED START IN PROGRESS TYPE type 


NAME name 


Explanation: The table space or index space identified by 
TYPE and NAME could not be started immediately. The START 
is deferred until all the log records applicable to the table 
space or index space have been applied. 


TYPE and NAME identify the table space or index space that 
could not be started. The TYPE code identifies the type of the 
table space or index space. 


Type codes '00000200' and '00000201' apply to this message. 
Refer to the Figure 4 in Appendix B, “Problem Determination” 
on page X-5 for an explanation of resource type codes. 


[ = Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILSTS 


a End of Internal DB2 Information | 


System Action: The identified table space or index space is 
started at a later time. The other table spaces or index spaces 
to be started (if specified) are started normally. 


User Response: Issue a -DISPLAY command for the specified 
table space or index space periodically to determine whether it 
has been started. 


DSNI0071 csect-name UNABLE TO START/RECOVER 
BECAUSE UNABLE TO DIRECT READ ALOG 


RECORD LOGRBA logrba 


Explanation: Unable to START (or RECOVER) because the nec- 
essary log records could not be accessed. Either an error 
occurred while attempting to allocate or open the log data set 
or an expected log record was not found on the log. 


If the message is in response to a START command, issue the 
-DISPLAY command to determine which resource(s) was not 
started. If the message is in response to a RECOVER utility, the 
resource is the table space or index space that is the object of 
the RECOVER. 


LOGRBA gives the log RBA of the log record that is unavail- 
able. 


[fee 8 oe Internal DB2 Information ——¢ ~= 4 
This message is issued by the following CSECT(s): DSNIDEFR 


po es End of Internal DB2 Information a 


System Action: The resource is not started (or recovered) and 
remains in the current state. If this is a START command, the 

resources are processed normally if there are other databases 
or spaces to be started and they do not involve reading the log. 


User Response: Resubmit the utility, or reissue the START 
command, when the problem with the log has been resolved. 


System Programmer Response: Run Print Log utility. This may 
be run with DB2 up or down. Find the data set that contains the 
requested RBA in the output of Print Log. If the required RBA is 
not in a listed data set, one of the following may have occurred: 
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¢ The data set was deleted from the bootstrap data set by a 
run of the Change Log Inventory utility. In this case, rerun 
the utility to insert the missing data set name. DB2 must be 
down to run this utility. 


¢ The bootstrap data set has been damaged. In this case, the © 
BSDS must be restored from the dump that occurred with 
the most recent archive log data set. Change Log Inventory 
must be run to supply changes that occurred during and 
after the last off-load operation. Changes may be deter- 
mined from the operator’s console listing. 


If a listed log data set contains the required RBA, this message 
will be preceded by one or more error messages from the log 
manager (DSNJ). See these messages for appropriate action. 


Problem Determination: Issue the -DISPLAY command to verify 
what got started. 


DSNI008I DATABASE VALIDATION PROCEDURE name 


COULD NOT BE LOADED 


Explanation: The database validation procedure identified by 
‘name' could not be loaded. 


aoe! Internat DB2 Information i ay 
This message is issued by the following CSECT(s): DSNIENSR 


ee End of internal DB2 Information eet 


User Response: Correct the name, and rerun the application. 


DSNIOOSI csect-name DATABASE EDIT PROCEDURE name 


COULD NOT BE LOADED 


Explanation: The database edit procedure identified by 
‘name' could not be loaded. 


| Internal DB2 information 


This message is issued by the following CSECT(s): DSNIENSR, 
DSNIREDR 


tas eee End of Internal DB2 Information eed ioa eae 


User Response: Correct the name, and rerun the application. 


DSNIO10I BROKEN PAGE ACCESSED TYPE type NAME 
name MODNAME csect-name CONN-ID id 


CORR-ID id LUW-ID id 


Explanation: The page identified by TYPE and NAME could not 
be accessed, because it is marked as logically broken. 


The TYPE and NAME identify the resource that is currently una- 
vailable. The TYPE code identifies the type of the resource as 
well as the format and content of the resource NAME. 


Type codes '00000301', '00000302', and '00000303' apply to 
this message. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for a table showing all types and 
names. 


‘csect-name' has encountered the logically broken page. 
CONN-ID, CORR-ID, and LUW-ID identify the thread involved in 
the problem. If the LUW-ID is an '*', the thread originated at 
this site. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNIADBR 


iS ote ot End of Internal DB2 Information es 


User Response: If the TYPE is '00000300', use NAME to deter- 
mine if the page is in an index space or a table space. Use the 
REPAIR utility to fix the broken page. Refer to Section 4 of 
Diagnosis Guide and Reference for information about broken 
pages. 


DSNIO111 PAGE TEMPORARILY UNAVAILABLE TYPE type 
NAME name MODNAME modname ERQUAL 


erqual 


Explanation: The page identified by TYPE and NAME has been 
temporarily marked as logically broken to prevent access until 
it can be recovered. 


The TYPE and NAME identify the resource that is currently una- 
vailable. The TYPE code identifies the type of the resource as 
well as the format and content of the resource NAME. Refer to 
Figure 4 in Appendix B, “Problem Determination” on page X-5 
for an explanation of resource type codes. 


The module named modname has called a page checking 
routine, which discovered an error in the page. 


The ERQUAL gives the trace id for the error in the page. Refer 
to Section 8 of Diagnosis Guide and Reference for explanation 
of this trace id. 


| ——— Internal DB2 Information Sh 
This message is issued by the following CSECT(s): DSNIBROK 


| End of internal DB2 Information ____s 


System Action: Automatic recovery for the page has been 
scheduled. The current agent wil! abend with reason code 
'00C90105', and a dump will be taken. The page will be una- 
vailable to this and other agents until the online recovery has 
completed successfully. Message DSNI010I will be issued, and 
a ‘resource unavailable' condition will be returned to any 
agents that attempt to access the page. If the online recovery 
fails, the page will be marked as broken until it is repaired or 
recovered (see message DSNI012I). 


User Response: Save the dump. Watch for message DSNB215l 
{indicating successful recovery of the page), or DSNI012I (indi- 
cating failure of recovery of the page). 


DSNI012i PAGE LOGICALLY BROKEN TYPE type NAME 


name MODNAME modname ERQUAL erqual 


Explanation: The page identified by TYPE and NAME is log- 
ically incorrect. Additional attempts to access the page will be 
denied. 


The TYPE and NAME identify the resource that is currently una- 
vailable. The TYPE code identifies the type of the resource as 
well as the format and content of the resource NAME. Refer to 
Figure 4 in Appendix B, “Problem Determination” on page X-5 
for an explanation of resource type codes. 


The module named 'modname' has called a page checking 
routine, which discovered an error in the page. 
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The ERQUAL gives the trace id for the error in the page. Refer 
to Section 5 of Diagnosis Guide and Reference for an explana- 
tion of this trace id. An ERQUAL of X'0000' indicates that an 
abend occurred during online recovery or recover utility. The 
page has been marked as broken, and the recovery has failed. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNIBHRE, 
DSNIBROK, DSNIDEFR, DSNHOP 


eee End of Internal DB2 Information se ee 


System Action: The page is marked as logically broken, an 04E 
abend with reason code '00C90102' is issued, and a dump is 
taken. The page will be unavailable to this and other agents 
until it is repaired. 


User Response: Save the dump for analysis by IBM Support 
Center. Copy the table space or index space to another data 
set for later analysis by IBM Support Center. Refer to Section 4 
of Diagnosis Guide and Reference for information on page 
format. 


Operator Response: Notify the system programmer. 


System Programmer Response: See the Explanation section of 
this message. 


DSNI0131 csect-name POTENTIALLY INCONSISTENT DATA 
REASON reason ERQUAL erqual TYPE type NAME 


name CONN-ID id CORR-ID id LUW-ID id 


Explanation: This message identifies a page with potentially 
inconsistent data. The 'csect-name' in the message identifies 
the CSECT that issued the message. This message is issued 
for each page involved in the current data manager operation. 


The 'erqual' in the message identifies the specific abend in the 
CSECT that caused this message to be issued. This information 
and the reason code are used by IBM Support Center to identify 
the cause of the problem. 


‘name’ and 'type' identify the page and its type. The TYPE 
code identifies the type, as well as the format and content, of 
the NAME. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for a table showing all types and 
names. 


CONN-ID, CORR-ID, and LUW-ID together identify the thread 
involved in the problem. If the LUW-ID is an '*', the thread 
originated at this site. 


For further information, see the Explanation section for the 
abend reason code specified in this message. 


System Action: The job is abended shortly after this message 
appears. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run. Save this output for use in 
problem determination. 


System Programmer Response: See the Problem Determi- 
nation section for the specific abend reason code. 


Probiem Determination: See the System Programmer 
Response section of the abend reason code specified in this 
message. 
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DSNI014I csect-name DATA IN USE DURING ABEND 
REASON 00C90101 ERQUAL erqual TYPE type 


NAME name CONN-ID id CORR-ID id LUW-ID id 


Explanation: This message identifies a page that was in use at 
the time an abend condition occurred with reason code 
'00C90101' (internal data manager error). The 'csect-name' in 
the message identifies the CSECT that issued this message. 
This message is issued for each page involved in the current 
data manager operation. 


The 'ERQUAL' in the message identifies the specific abend in 
the CSECT that caused this message to be issued. This infor- 
mation and the reason code are used by IBM Support Center to 
identify the cause of the problem. 


NAME and TYPE identify the page and its type. The TYPE code 
identifies the type, as well as the format and content, of the 
NAME. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. 


CONN-ID, CORR-ID, and LUW-ID together identify the agent 
involved in the problem. If the LUW-ID is an '*', the thread 
originated at this site. 


For further information, see the Explanation section for abend 
reason code '00C90101'. 


System Action: The job will be abended, with the '00C90101' 
reason code, shortly after this message appears. 


User Response: Notify the system programmer. 
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Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: See the System Programmer 
Response section for abend reason code '00C90101' shortly 
after this message appears. 


Problem Determination: In general, the data in these pages is 
fine. However, if problems are reported that repeatedly involve 
the same pages or if the same pages are reported by other 
abends, you may want to analyze the set of pages involved. 
Refer to Section 4 of Diagnosis Guide and Reference for infor- 
mation about how to do this. 


See the Problem Determination section for abend reason code 
'00C90101'. 


DSNIO151 OBJECT name IS ALREADY STARTED FOR RW 


ACCESS. THE OBJECT WILL REMAIN STARTED 
FOR RW ACCESS 


Explanation: The -START OBJECT command with the 
ACCESS(FORCE) keyword was entered, but the object specified 
was already started for read/write access. 


| internal DB2 Information 2 ] 
This message is issued by the following CSECT(s): DSNILSTS 


[eee ee End of internal DB2 Information ee 


| 
| 
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Recovery Log Manager Messages (DSN4J...) 


DSNJO01I csect-name CURRENT COPY n ACTIVE LOG DATA 
SET IS DSNAME =..., STARTRBA —..., 


ENDRBA-... 


Explanation: When the log manager is initialized, it sends this 
informational message to identify the current active log data 
sets (copy-1 and, if dua! logging is used, copy-2). STARTRBA is 
the RBA of the next byte of log data to be written on the named 
data set. ENDRBA is the RBA of the last possible byte in the 
data set. This value might be needed for a conditional restart. 


Also, when an active log data set is full and a new one is allo- 
cated, this message identifies the new data set. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from log failures. 


a _ Internal DB2 Information 


This message is issued by the following CSECT(s): DSNJW007, 
DSNJW307 


De aes End of Interna! DB2 Information teseca es Al 


System Programmer Response: None required. However, if 
recovery is required, information from this message may be 
required as input to the change log inventory utility (DSNJU003). 


DSNJ002i. = FULL ACTIVE LOG DATA SET DSNAME -..., 


STARTRBA -=..., ENDRBA=... 


Explanation: This message is sent at the time the log manager 
fills an active log data set and switches to a new empty data 
set. The message shows the name and log RBA range of the 
full data set. 


[~ ee Internal DB2 information 
This message is issued by the following CSECT(s): DSNJW307 


[i ere ee End of Internal DB2 Information ete eB 


System Programmer Response: None required. However, if 
recovery is required information from this message may be 
required as input to the change log inventory utility (DSNJU003). 


DSNJOO3I FULL ARCHIVE LOG VOLUME DSNAME ~..., 
STARTRBA=..., ENDRBA=..., UNIT=..., 


COPYnVOL =..., VOLSPAN =..., CATLG =... 


Explanation: Offloading for the specified archive log data set 
was successfully completed for the given volume. If the data 
set spans multiple tape volumes, this message is generated for 
each tape voiume. 


a Internal DB2 Information ee ee 
This message is issued from the following CSECT(s): DSNJOFF3 


Re ateek to End of Internal DB2 information SA eed 


System Action: An archive log data set has been created, and 
the archive log data set inventory in the bootstrap data set 
(BSDS) has been updated with the information in the message: 


DSNAME 
STARTRBA 
ENDRBA 
UNIT 


The name of the archive log data set. 
The starting RBA contained in the volume. 
The ending RBA contained in the volume. 
The device unit to which the data set was allo- 
cated. 
the name of the volume. This message 
keyword is displayed as COPY1VOL if this is 
the copy-1 archive log data set, and as 
COPY2VOL if this is the copy-2 archive log 
data set. 
An indicator to denote one of four conditions: 
¢ If '00', the data set is entirely contained 
on the volume specified by 'COPYnVOL'. 
e If '01', this is the first entry of a multi- 
volume data set. 
If '11', this is the middle entry of a multi- 
volume data set. 
e If '10', this is the last entry of a multi- 
volume data set. 
An indicator to denote one of two conditions: 
¢ tf 'NO', the archive log data set is uncata- 
loged. 
e If 'YES', the archive log data set is cata- 
loged. 


COPYnVOL 


VOLSPAN 


CATLG 


The BSDS is automatically updated with the information con- 
tained in this message; however, if recovery is required, infor- 
mation from this message may be required as input to the 
change log inventory utility (DSNJU003). 


DSNJ0041 ACTIVE LOG COPY n INACTIVE, LOG IN SINGLE 


MODE, ENDRBA=... 


Explanation: This message is sent when the dual active 
logging option is selected and copy 'n' becomes inactive. A 
log copy becomes inactive when the next active log data set is 
not ready when required. ENDRBA is the last byte of log data 
written on copy 'n'. This is usually caused by a delay in off- 
load. 


jl internal DB2 Information ae 
This message is issued by the following CSECT(s): DSNJW307 


lee End of Internal DB2 Information | 


System Action: The log is switched to single mode until! the 
next data set for copy 'n' is ready for logging. 


Operator Response: Perform a display request to ensure that 
there are no outstanding requests that are related to the log off- 
load process. Take the necessary action to satisfy any 
requests, and permit off-load to continue. 


System Programmer Response: if the switch to single mode 
was Caused by the lack of a resource required for off-ioad, the 
necessary resource should be made available to allow off-load 
to complete and thus permit dual logging to proceed. If 
recovery is required, information from this message may be 
required as input to the Change Log Inventory utility 
(DSNJU003). 
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DSNJ005! ACTIVE LOG COPY n IS ACTIVE, LOG IN DUAL 


MODE, STARTRBA-... 


Explanation: This message is sent when copy 'n' of the log 
becomes active after previously being flagged as inactive. 
STARTRBA is the RBA of the first byte of log data written on 
copy 'n' after it was activated. 


[ ~~ Internal DB2 Information a ar | 
This message is issued by the following CSECT(s): DSNJW307 


(ane eet End of Internal DB2 Information Soe tee | 


System Programmer Response: None required. However, if 
recovery is required, information from this message may be 
required as input to the Change Log Inventory utility 
(DSNJU003). 


DSNJOO6 ALLOCATION FOR NEW ARCHIVE LOG DATA SET 


HAS BEEN CANCELLED BY OPERATOR. 


Explanation: This message is sent if the operator answers 'N' 
to the WTOR message DSNJOOS8E. 


i. 74 Internal DB2 Information aaa 
This message is issued by the following CSECT(s): DSNJDS01 


eer Eas End of Internal DB2 Information eee 


System Action: If the allocation is for copy 1 archive log data 
set, off-load terminates processing until the next time it is acti- 
vated. If copy 1 has already been allocated and this request is 
for copy 2, off-load switches to single offload mode for this data 
set only. 


DSNJO007! OPERATOR CANCELED MOUNT OF ARCHIVE 


dsname VOLSER = volser 


Explanation: Ifthe operator answers 'N' to the WTOR 
message DSNJOO9I this message is issued. 'dsname' is the 
name of the archive data set. 'volser' is the volume serial of 
an archive log volume required to satisfy the read request. 


ae Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNJDSO1 


eee fa End of Internal DB2 Information ee oe Seen 


System Action: The log manager fails the read request that 
needed the archive volume. If the request was issued with the 
'COND=YES' parameter, the log manager returns to its 
invoker with return code 12 and reason code '00D1032B'. Oth- 
erwise, the log manager’s invoker abends with the same 
reason code. 


DSNJOO8E nn OF mm ACTIVE LOGS ARE FULL. ssname 
NEEDS ARCHIVE SCRATCH. REPLY Y WHEN 


DEVICE READY OR N TO CANCEL. 


Explanation: The installation has requested a WTOR before 
archive log data set allocation. DB2 needs a scratch volume for 
offloading an active log data set. 'ssname' is the name of the 
DB2 subsystem. 'nn' is the number of full active log data sets. 
‘mm' is the total number of active log data sets. 
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er Internal DB2 Information ae ea 
This message is issued by the following CSECT(s): DSNJDSO1 


tee et End of Internal DB2 Information eae: 


System Action: The off-load task waits for the operator’s reply. 
Operator Response: The operator has three options: 


* Get a scratch tape ready, make sure there is an available 
unit for the tape, and reply 'Y'. DB2 then continues with 
the off-load. 


¢ Determine from the number of active log data sets available 
whether the off-load can be delayed until the next time an 
active log data set becomes full. If the process can be 
delayed, then reply 'N'. 


This response has two possible effects. 


— If dual archive logging is in effect and this allocation is 
for a copy 1 archive data set, the 'N' response delays 
the off-load process until the next active log data set 
becomes full. 


— However, if the copy 1 archive data set has already 
been allocated and this request is for copy 2, the 'N' 
response causes the off-load to switch to single archive 
mode (the switch is for this data set only). 


¢ Defer giving a response. This causes off-load to wait before 
processing. However, because off-load is a separate 
service task, the wait does not affect DB2 performance. 


DSNJOOSE ssname NEEDS VOL SER=nnnnnn. REPLY Y TO 


CONTINUE OR N TO CANCEL 


Explanation: The installation has requested WTOR before 
archive log data set allocation. DB2 needs the specified 
archive volume for a read operation. 'ssname' is the name of 
the DB2 subsystem. 


| : Internal DB2 Information — es 
This message is issued by the following CSECT(s): DSNJDSO1 


Oh. see 2 End of Internal DB2 Information tee te S| 


System Action: The archive log read service task waits for the 
operator's reply. This wait affects the agent for which the log 
read was issued and any other agents that may be waiting on 
the log read service task queue. 


Operator Response: Locate the requested volume, ensure that 
a device is available, and reply 'Y'. DB2 continues with 
dynamic allocation and then begins reading the log. 


If dual archiving is in effect, a response of 'N' will cause 
archive read to re-issue the message for the copy 'Z' copy 2 
archive VOLSER with the same RBA range. A response of 'N' 
to this second WTOR, or to the initial WTOR for single archiving, 
will cause the archive read service task to fail with unpredict- 
able results. 


DSNJO10! csect-name INVALID RESPONSE. WTOR WILL BE 


REPEATED. 


Explanation: During archive data set allocation a WTOR was 
requested, but not available. The user did not respond to the 
error message. Either 'Y' or 'N' must be entered. 


| ~ Internal DB2 Information ie ee tl 


This message is issued by the following CSECT(s): DSNJDS01, 
DSNJW006 


i tadeeree era End of Internal DB2 Information ig eee ol 


System Action: The original WTOR is repeated. 


Operator Response: Reply as indicated in the repeated 
message. 


DSNJO0111 CONDITIONAL RESTART RECORD rrr CREATED 
AT.... WAS FOUND. REPLY Y TO USE, N TO 


CANCEL 


Explanation: When the Log Manager was initialized, a condi- 
tional restart control record was found in the bootstrap data set. 
Both the record identifier (a 4 byte hexadecimal number) and 
the creation time stamp (yy.ddd hh:mm) are displayed to help 
identify the conditional restart record which will be used. If you 
want a conditional restart using that record, reply 'Y' to the 
message. Otherwise, reply 'N' and notify the system pro- 
grammer. 


System Action: If 'Y' is the response, DB2 is started condi- 
tionally, using the record found. If 'N' is the response, DB2 
startup is terminated. 


Operator Response: if a DB2 conditional restart is to be done 
and if the date and time displayed are correct, then reply 'Y' to 
the outstanding message. If you are not sure, then contact the 
system programmer. 


System Programmer Response: If anormal restart of DB2 has 
failed and you have created a conditional restart control record 
with the Change Log Inventory utility, check whether the time 
and date in the message agree with when you created that 
record. If they do, reply 'Y' to the outstanding WTOR. if they 
do not, reply 'N' and investigate the discrepancy. 


DSNJ0121 ERROR ccc READING RBA rrr IN DATA SET ddd 
CONNECTION-ID = xxxxxxxx, 


CORRELATION-ID = yyyyyyyyyyyy 


Explanation: While scanning log records read into a buffer, the 
log manager detected a logical error with reason code ccc. rrr 
is the log RBA of the segment in the buffer at which the error 
was detected. ddd is the name of the active or archive log data 
set from which the record was read. If ddd is blank, the data 
was read from an active log output buffer. 


The connection and correlation IDs identify the user or applica- 
tion that encountered the problem. Messages that have the 
same connection ID and correlation ID relate to the same user. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from log failures. 


[ 3 : Internal DB2 information 


This message is issued by the following CSECT(s): DSNJR005, 
DSNJOFF1, DSNJOFF4, DSNJWO009 


ee’, End of Internal DB2 Information a eee 


System Action: The application program that invoked the log 

manager is terminated with reason code ccc. However, infor- 

mation in this message may be useful in diagnosing the abend 
that will follow. 
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DSNJ0131 TERMINAL ERROR ccc IN BUFFER rrr BEFORE 


ACTIVE LOG WRITE 


Explanation: A scan ofthe log output buffer just prior to writing 
the buffer detected an inconsistency in the log data. ccc is the 
abend reason code associated with the SDUMP that is 
produced. rrr is the log RBA at which the error was detected. 


as internal DB2 Information Ee oe 
This message is issued by the following CSECT(s): DSNJW107 


{send of Internal DB2 information ___ | 


System Action: DB2 will terminate with a dump, and will not 
write the damaged buffer to either COPY 1 or COPY 2 active log 
data set. 


Operator Response: Notify the system programmer. Start DB2 
after it terminates. 


System Programmer Response: Because the damaged buffer 
has not been written to a log data set, DB2 may be restarted. 
No corrective action is required. 


Problem Determination: In the DB2 formatted block section of 
the dump, locate the chain of LBCE blocks. Those are log 
buffer control elements, and each LBCE controls one 4K log 
output buffer. LBCEBUFF, at offset X‘'20' in the LBCE, points to 
the buffer, which is always on a 4K boundary. The log RBA of 
the first byte of the buffer is in a 6-byte field at offset X'FF2' in 
the buffer itself. The layout of the buffer is described by the 
DSNDLCID mapping macro. The header of each record within 
the buffer is described by the DSNDLRH mapping macro. 
Locate the buffer that contains the log RBA from the message 
and find the damage by referring to the description of the 
reason code later in this book. 


DSNJ0141 TERMINAL ERROR ccc IN BUFFER rrr AFTER 


ACTIVE LOG WRITE. 


Explanation: A scan of the log output buffer, after writing to the 
COPY 1 active log data set and before writing to COPY 2, 
detected an inconsistency in the log data. ccc is the abend 
reason code associated with the SDUMP that is produced. rrr is 
the log RBA at which the error was detected. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJW107 


eee End of Internal DB2 Information eles | 


System Action: DB2 will terminate with a dump, and will not 
write the damaged buffer to the COPY 2 data set. 


Operator Response: Notify the system programmer. 


System Programmer Response: The biock containing the indi- 
cated log RBA may be damaged. The buffer was found to be in 
error at the completion of the write to the COPY 1 data set of the 
active log. 


If dual active logs are being used, use print log map 
(DSNJU004) to list the active log data sets for both copies of the 
active log. Find the COPY 2 data set with the corresponding 
RBA, and copy that data set (using Access Method Services 
REPRO) to the COPY 1 data set. Start DB2. 


If only a single active log is used, contact the IBM support 
center for assistance. An attempt to start DB2 may succeed if 
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the damage to the buffer occurred after completion of the write 
to DASD. 


Problem Determination: !n the DB2 formatted block section of 
the dump, locate the chain of LBCE blocks. Those are log 
buffer control elements, and each BCE controls one 4K log 
output buffer. LBCEBUFF, at offset X'20' in the LBCE points to’ 
the buffer, which is always on a 4K boundary. The log RBA of 
the first byte of the buffer is in a 6-byte field at offset X'FF2' in 
the buffer itself. The layout of the buffer is described by the 
DSNDLCID mapping macro. The header of each record within 
the buffer is described by the DSNDLRH mapping macro. 
Locate the buffer that contains the log RBA from the message 
and find the damage by referring to the description of the 
reason code later in this book. 


DSNJO15! CSRONLY PROHIBITS LOG ALTERATIONS. 
RECORD rrr CREATED .... REPLY Y TO USE, N TO 


CANCEL. 


Explanation: Ouring DB2 startup, the Log Manager found an 
inactive conditional restart control record in the bootstrap data 
set. Because this control record indicates CSRONLY, no log 
data sets will be modified. If log truncation was specified, it will 
be simulated. Only the first phase of restart (current status 
rebuild) will be performed. The hexadecimal identifier (rrr) and 
creation timestamp (yy.ddd hh:mm) identify the record found. 


[ — internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJS001 


[bia see ees: End of Internal DB2 Information gees os 


System Action: A ‘Y' reply will continue the conditional 
restart. A 'N' reply will terminate DB2 startup. 


Operator Response: To continue this CSRONLY processing, 
reply 'Y' to this message. If you are not sure, contact the 
system programmer. 


System Programmer Response: The conditional restart control 
record will not be deactivated at the end of the CSRONLY proc- 
essing. To deactivate this record, either cancel this record or 
create a new record. Refer to Section 5 (Volume 2) of Adminis- 
tration Guide for more information. 


DSNJO20I csect-name RECEIVED REPLY OF N TO msg-num. 


SUBSYSTEM STARTUP IS TERMINATED. 


Explanation: The operator chose to terminate DB2 startup by 
answering 'N' to 'msg-num'. 


aes ~~ Internal DB2 Information ~——_————— 4 


This message is issued by the following CSECT(s): DSNJW006, 
DSNJW306 


| End of Internal DB2 Information __———| 


System Action: DB2 will not restart. 


Operator Response: To restart DB2, foliow the ‘operator 
response’ of 'msg-num'. 
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RBA RANGE startrba TO endrba NOT AVAILABLE 
IN ACTIVE LOG DATA SETS 


DSNJ0301 


Explanation: Previous errors have made the active log data 
set(s) that contain the relative byte address (RBA) range 
reported in the message unavailable to DB2. The status of 
these log(s) is STOPPED in the bootstrap data set (BSDS). 


| Internal DB2 Information eT 
This message is issued by the following CSECT(s): DSNJW106 


Teese ees End of Internal DB2 Information Ree eee 


System Action: DB2 terminates with a dump. 
Operator Response: Notify the system programmer. 


System Programmer Response: The log RBA range must be 
available for DB2 to be recoverable. Correct previous errors 
and restore the active log data set(s) that contain the RBA 
range reported in the message. 


e If the log data set(s) are recoverable, the active log data set 
inventory in the BSDS must be modified to reset the 
STOPPED status. Use the Print Log Map utility (DSNJU004) 
to obtain a copy of the BSDS log inventory. Next, use the 
Change Log Inventory utility (DSNJU003) to delete the active 
log data sets marked STOPPED (use the DELETE state- 
ment), and then add them again (use the NEWLOG state- 
ment). The starting and ending RBA for each active log 
data set must be specified on the NEWLOG statement when 
the log(s) are added back to the BSDS using the Change 
Log Inventory utility. 


¢ Ifthe log data set(s) are not recoverable, it is necessary to 
conditionally restart DB2. See Section 5 (Volume 2) of 
Administration Guide for additional information on condi- 
tional restart and recovering from log failures. 


Problem Determination: Examine previous messages to deter- 
mine the reason the active log data set(s) are unavailable to 
DB2. 


DSNJOS50! LOAD MODULE DSNJL003 DOES NOT HAVE 


RMODE(24) ATTRIBUTE 


Explanation: The named load module was not link edited with 
the required RMODE(24) attribute. 


nia Internal DB2 Information ~~ S 
This message is issued by the following CSECT(s): DSNJSO001 


{| seEnd of Internal DB2 Information ____————_— 


System Action: DB2 startup is terminated. 


Operator Response: Notify the system programmer of the 
failure. 


System Programmer Response: Verify that all installation and 
maintenance activities against this module were executed 
using SMP. Verify that the JCLIN for SMP includes the correct 
RMODE control statement, and that the Linkage Editor provided 
with the Data Facility Product (DFP) for MVS/XA was invoked by 
SMP for the link edits. Correct the procedure or JCL which 
caused the error and rerun the necessary SMP jobs. 


Problem Determination: The MVS/XA service aid AMBLIST 
provides Linkage Editor module attributes in the summary 
section of the LISTLOAD function output. 


DSNJO6OI THE LOADED csect-name IS OBSOLETE. PLEASE 
REASSEMBLE IT AND RELINKEDIT THE 


DSNZPARM LOAD MODULE. 


Explanation: The DSNZPARM CSECT 'csect-name' is out-of- 
date. This error can only occur if code maintenance has been 
applied, but 'csect-name' has not been reassembled. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJS001 


[| End of Internal DB2 Information ___——_— 


System Action: DB2 is terminated with abend reason code 
'00E80084'. 


Operator Response: Notify the system programmer. 


System Programmer Response: Reassemble the CSECT, and 
relink-edit the DSNZPARM load module. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


DSNJ072E ARCHIVE LOG DATA SET dsname HAS BEEN 
ALLOCATED TO NON-TAPE DEVICE AND CATA- 
LOGED. ZPARM CATALOG OPTION OF 'NO' HAS 


BEEN OVERRIDDEN. 


Explanation: By way of an archive log DSNZPARM parameter, 
the user specified that ali archive log data sets should be uncat- 
aloged (CATLG=NO). However, DB2 requires that all archive 
log data sets allocated to non-tape devices must be cataloged. 
The archive log data set specified by 'dsname' has been allo- 
cated to a non-tape device, and has thus been cataloged. The 
user’s DSNZPARM CATLG setting of 'NO' has been overridden. 


ne Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJDS04 


[bao End of Internal DB2 Information a 


System Action: The archive log data set has been allocated to 
a non-tape device, and has been cataloged. The DSNZPARM 
CATLG=NO setting has been overridden. The BSDS reflects 
that the data set has been cataloged. 


Operator Response: Notify the system programmer. 


System Programmer Response: The DSNZPARM parameters 
for the log archive function must be changed. Specifically, the 
ARCHCTLG and ARCHDEVT fields are not consistent with one 
another. For details concerning the course of action required 
to eliminate this problem, refer to the Section 2 (Volume 1) of 
Administration Guide under the DSNTIPA panel and DSN6ARVP 
macro subtopics. 


DSNJ0731 LOG ARCHIVE UNIT ALLOCATION FAILURE 
DETECTED, RETURN CODE =nnnn. ALLOCATION 
OR OFF-LOAD OF ARCHIVE LOG DATA SET MAY 


FAIL. 


Explanation: While building the SVC99 text entries to dynam- 
ically allocate a new archive log data set, a unit allocation 
failure was detected. The reason code, indicated by 'nnnn' in 
the message, further clarifies the problem as follows: 


DSNJO60I — DSNJO73I 


4 (X'04') The device type (unit name) on which the archive 
log data set is to be allocated is specified by the 
user in ZPARMs. This device type (unit name) 
could not be found in the MVS eligible device 


table (EDT). 


16 (X'10') Non-fetch protected storage could not be 
obtained by an MVS service to build a list of 


devices. 


32 (X'20') DB2 was able to obtain a list of devices corre- 

sponding to the device type (unit name) specified 
in ZPARMs. However, it was determined by DB2 
that this list contained a mixture of tape and non- 


tape devices. 


36 (X'24') Non-fetch protected storage could not be 
obtained by DB2 to build a parameter list for an 


MVS service. 


40 (X'28') The device type (unit name) specified by the user 
in ZPARMs is valid. However, no devices are 
currently associated with the given device type 


(unit name). 


44 (X'2C') The device type (unit name) specified by the user 
in ZPARMs is valid. However, no DASD volumes 
are available with a volume use attribute of 


‘storage’. 


ee Internal DB2 Information rs) 
This message is issued by the following CSECT(s): DSNJDSO1 


te Fo. oe End of Internal DB2 Information ere 


System Action: This message is issued by DB2 after the SVC99 
text entries are built, but prior to the allocation of the new 
archive log data set. As a result of the error, the dynamic allo- 
cation of the archive log data set will be attempted using 
standard default values. The standard default values are gen- 
erally acceptable; however, the allocation may fail or the sub- 
sequent off-load may produce undesirable processing results. 
For example: 


¢ Areturn code of 4 or 44 (X‘2C') will foretetl an allocation 
error (DSNJ103!) when the SVC99 is issued for the archive 
data set. 


* Off-load processing to tape may fail. DB2 uses a volume 
count of 20 when allocating to tape, and uses the standard 
MVS volume count default of 5 volumes when writing to 
non-tape devices. In the case of most of the above errors, it 
would be impossible for the DB2 subsystem to determine 
the device type on which the data set is to be allocated. 
Therefore, the standard MVS default is assumed for the 
volume count. If the data set is successfully allocated to a 
tape device, and the volume of data is such that more than 
five volumes will be used for the archive data set, the off- 
load processing will receive an MVS ABEND 837-08 with 
message IEC028! when attempting to write to the sixth tape 
volume. 


¢ Off-load processing to a direct access device may fail. 
When allocating a new archive log data set on a direct 
access device, the DB2 subsystem will use a unit count to 
facilitate multivolume archive data sets. With most of the 
above errors, it may be impossible for the DB2 subsystem 
to correctly determine the type of device on which the data 
set is to be allocated. Therefore, the standard default (1) is 
assumed for the unit count. If the data set is successfully 
allocated to a direct access device, and during the off-load 
processing it becomes necessary to extend the data set to 
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another device, the off-load processing will receive an MVS 
B37 (out of space) ABEND, and the archive log data set will 
be deallocated. 


Operator Response: Notify the system programmer. 


System Programmer Response: The required action is based 
on the return code indicated in the message. 


4(X'04') The most likely cause is an incorrect specification in 
the Archive Log ZPARMs (DSNTIPA panel). Correct 
the DEVICE TYPE field. if the DEVICE TYPE field 
from the Archive Log ZPARMs appears to be correct, 
check the EDT to ensure that the esoteric or generic 
unit name specified in the ZPARMs is actually in the 
EDT. Subsequent off-load processing wil! archive 
the log data which could not be previously archived 
due to the allocation failure (DSNJ103)). 


16 (X'10') or 36 (X'24') 
This is usually a temporary problem. If the allo- 
cation of the archive log data set is successful, no 
action is required to correct this situation. If this is a 
recurring problem, then sufficient page space is not 
available, and the region size for the DB2 data 
systems services may have to be increased, or 
standard MVS diagnostic procedures may have to be 
used to correct the problem. 


32 (X'20') or 40 (X'28') 
To correct this situation, change the Archive Log 
DEVICE TYPE ZPARM to use a device type (unit 
name) which contains homogenous devices, or 
modify the device list associated with the device 
type (unit name) via a system generation to supply a 
list of homogenous devices. 


44 (X'2C') 
To correct this situation, issue an MVS mount 
command to change the volume use attribute of a 
mounted ‘private' volume to 'storage'. If this is a 
recurring problem, a system generation may be 
required to add permanently resident volumes with 
a volume use attribute of 'storage' to the esoteric or 
generic unit unit, or ZPARMs may have to be 
changed to use a different esoteric or generic unit 
name for the DEVICE TYPE (on the DSNTIPA installa- 
tion panel). 


DSNJ1001! csect-name ERROR OPENING BSDSn 


DSNAME =..., ERROR STATUS = eeii 


Explanation: Log manager initialization or the -RECOVER 
BSDS command could not open the specified bootstrap data set 
(BSDS). BSDSn matches the ddname in the log startup JCL of 
the data set that cannot be opened. The value of 'n' is 1 or 2. 
The ‘error status' contains the VSAM open return code in 'ee', 
and the VSAM open reason code in 'ii'. Refer to MVS VSAM 
Administration MVS VSAM Administration: Macro Instruction 
Reference for a list of the VSAM open return codes and reason 
codes. Refer to Section 5 (Volume 2) of Administration Guide 
for information about recovery from BSDS or log failures. 


[ : Internal DB2 Information 


This message is issued by the following CSECT(s): DSNJC004, 
DSNJBO06 


ne ener End of Internal DB2 Information eee 


System Action: When this error occurs at initialization time, 
DB2 startup must be terminated, because the log data sets 
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cannot be determined and allocated without the BSDS. When 
this error occurs during -RECOVER BSDS processing, the 
command is terminated, and the system continues in single 
BSDS mode. 


Operator Response: Notify the system programmer. 


System Programmer Response: Recover the BSDS that cannot 
be opened. Normally, if dual BSDSs are being used, recovery 
consists of making a copy of the remaining good BSDS. 


Problem Determination: The ‘error status' contains the VSAM 
open return code in 'ee', and the VSAM open reason code in 
‘ii'. Refer to MVS VSAM Administration MVS/370 VSAM Admin- 
istration: Macro Instruction Reference for a list of the VSAM 
open return codes and reason codes, and the steps required to 
take corrective action. 


DSNJ101E  csect-name CRCRERBA OF rrr IS xxx THAN ANY 
KNOWN RBA, BUT COLD START WAS NOT SPECI- 


FIED. 


Explanation: Truncation cannot take place because the CRCR 
end RBA is not in the range of RBA values known to either the 
active or archive logs. 'rrr' is the end RBA specified in the 
active record. 'xxx' is replaced by either HIGHER or LOWER. 
lf HIGHER is the case, the CRCRERBA is higher than the end 
RBA of the most recent active log data set. LOWER means the 
CRCRERBA is lower than the starting RBA of the oldest archive 
data set. 


| . Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJW306 


Dee End of Internal DB2 Information | 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Most likely, the archive log 
data set that contained the requested RBA has been deleted 
from the bootstrap data set (BSDS) by the Change Log Inven- 
tory utility. Locate the output from an old Print Map run, and 
identify the data set that contains the missing RBA. If the data 
set has not been reused, run the Change Log Inventory utility to 
add this data set back into the inventory of log data sets. 
Restart DB2. 


DSNJ102I LOG RBA CONTENT OF LOG DATA SET 


DSNAME =..., STARTRBA=..., ENDRBA=..., 
DOES NOT AGREE WITH BSDS INFORMATION 


Explanation: The log RBA range shown in the BSDS for the 
specified data set does not agree with the content of the data 
set. 


| Internal DB2 Information Se + 
This message is issued by the following CSECT(s): DSNJW009 


| End of Internal DB2 Information 


System Action: DB2 startup processing is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Use the Print Log Map and 
Change Log Inventory utilities to make the BSDS consistent with 
the log data sets. 


DSNJ1031 LOG ALLOCATION ERROR DSNAME = dsname, 


ERROR STATUS = eeeeiiii 


Explanation: The log manager encountered an error while 
attempting to allocate the active or archive log data set indi- 
cated by the DSNAME = keyword. The STATUS = keyword indi- 
cates the error reason code returned by MVS dynamic 
allocation. 


This message may be preceded by message DSNJO73l. 


| Internal DB2 Information ~ 
This message is issued by the following CSECT(s): DSNJDSO1 


Eilean ee End of Internal DB2 Information Se 


System Action: Subsequent log manager actions are based 
upon the type of data set involved. 


For active log data sets, if the error is encountered during log 
manager initialization, DB2 startup is terminated. If two copies 
of the active log data sets are defined, this message appears 
only once. 


For archive log data sets, if two copies of the archive log data 
sets are defined, processing continues on the remaining 
archive log data set. 


Operator Response: Notify the system programmer. 


System Programmer Response: For active log data sets, if the 
problem occurred during DB2 initialization, you can resolve the 
problem by doing one of the following: 


* Resolve the error associated with the active log data set as 
indicated by STATUS = keyword. 


¢ Via AMS, provide another copy of the active log data set; 
update the BSDS with the Change Log Inventory utility 
(DSJU003); restart DB2. 


For archive log data sets: 


* Ifthe problem occurred during allocation with the intent to 
write the data set, no immediate action is required. 
However, failure to resolve the SVC99 error (indicated by 
the STATUS value in the message) may eventually cause 
the available space in the active log to be exhausted 
(DSNJ111E), since all future off-loads may fail due to the 
same error. 


* Ifthe problem occurred during allocation with the intent to 
read the data set, determine the problem, and use the 
Change Log Inventory utility (DSNJU003) DELETE function to 
delete the archive log data set from the BSDS archive log 
inventory. Then use the NEWLOG function to add the data 
set back into the archive log inventory, pointing to the 
correct volume and device. 


Problem Determination: The error status portion of this 
message contains a 2-byte error code (S9Q9ERROR) followed by 
the 2-byte information code (S99INFO) from the SVC request 
block. Refer to the appropriate MVS publication for a 
description of these codes. 


DSNJ103i — DSNJ104I 


DSNJ1041 csect-name RECEIVED ERROR STATUS nnnnnnnn 


FROM macro-name FOR DSNAME dsname 


Explanation: The jog manager encountered an error while 
issuing the macro 'macro-name'. The error status is the return 
code from the specified macro. 


¢ For an OPEN of a non-VSAM data set, the error status is 
zero. 


¢ For an OPEN of a VSAM data set, the return code in the 
error field of the access method services control block is 
included in this message as the error status value. Refer to 
the appropriate VSAM publication for a definition of these 
values. 


¢ For MMSRV errors, the error status contains the error infor- 
mation returned by media manager services. If a MMSRV 
CATUPDT failure occurs attempting to truncate an active log 
data set, the log data set is unavailable to DB2 and the 
status of the log data set is STOPPED in the bootstrap data 
set (BSDS). 


* For both VSAM OPEN and MMSRV errors, this message is 
preceded by an IEC161I message that defines the error that 
occurred. Refer to the appropriate MVS publication for a 
description of the MMSRV return codes. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from log failures. 


ars, — Internal DB2 Information 


This message is issued by the following CSECT(s): 
DSNJDS02 DSNJDS04 DSNJW106 


ee End of Internal DB2 Information aoe | 


System Action: If this condition is encountered during log 
manager initialization, DB2 start terminates. If the error occurs 
later and the data set is needed for either off-load or input oper- 
ations, log manager processing continues. if a second copy of 
the data is available, the log manager attempts to allocate and 
open the second data set. 


lf the data set is needed as an active log data set, the log 
manager attempts to retry the failing request. If the retry fails 
and DB2 is unable to switch its log processing to an available 
active log data set, the DB2 subsystem terminates. The termi- 
nation of DB2 is required only if DB2 detects a condition that 
would produce a missing relative byte address (RBA) range in 
the active log (message DSNJO301). 


Operator Response: Notify the system programmer. 


System Programmer Response: Ifthe error occurred during 
initialization, the user’s site must either correct the problem so 
that the data set is available or provide another copy of the data 
set and change the BSDSs to point to the new data set. 


If the error occurred during DB2 processing, review the return 
code and take the appropriate action to correct the problem so 
that the data set can be used at a later time or the data set 
entry can be removed from the BSDS via the Change Log Inven- 
tory utility. 
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csect-name LOG WRITE ERROR DSNAME -..., 
LOGRBA=—..., ERROR STATUS = ccccffss 


DSNJ1051 


Explanation: The log manager encountered a write error in the 
specified active log data set. If 'csect-name' is DSNJW107, the 
error occurred writing the log buffers to an active log data set. 
If 'csect-name' is DSNWJ207, the error occurred while prefor- 
matting the next control area before writing log data into it. 


Error status contains the error information returned by media 
manager in the form 'ccccffss', where 'cccc' is a 2-byte return 
code that describes the error, 'ff' is a 1-byte code that defines 
the functional routine that detected the error, and 'ss' is the 
1-byte status code that defines a general category of error. 
Refer to the appropriate MVS publication for a description of 
the MMCALL return codes. 


if the dual active logging option is selected, the log manager 
switches to the next data set for this copy. If the next data set is 
not ready, the log manager temporarily enters single logging 
mode and allocates a replacement data set for the one that 
encountered the error. Dual logging is resumed as soon as 
possible. 


If single active logging option is selected and the next data set 

is not ready, the log manager waits for that data set to be avail- 
able. In this case, log writing is inhibited until the replacement 
is ready for output. 


[pe ae Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNJW107, 
DSNJW207 


aoe ee End of Internal DB2 Information py ee 


System Action: See the Explanation section of this message. 


‘Operator Response: Notify the system programmer. 


System Programmer Response: See the Explanation section of 
this message. 


DSNJ106! LOG READ ERROR DSNAME -..., LOGRBA=..., 


ERROR STATUS = ccccffss 


Explanation: The log manager encountered an error while 
reading an active log data set. The ‘error status' contains the 
error information returned by the media manager in the form 
‘ccccffss', where 'cccc' is a 2-byte return code that describes 
the error, 'ff' is a 1-byte code that defines the functional routine 
that detected the error, and 'ss' is the 1-byte status code that 
defines a general category of error. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJROO7 


Le ete End of Internal DB2 Information eee 


System Action: If another log data set contains the data, the 
log manager attempts to read the data from the alternate 
source. If an alternate source is not available, the log manager 
returns a read error return code to the application program 
requesting the log data. 


Operator Response: Notify the system programmer. 


System Programmer Response: [f the site is using dual 
logging, the requested RBA was probably retrieved from the 
corresponding dual active log data set, and no immediate 
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response is necessary. However, if this error occurs fre- 
quently, or if the site is using single logging, immediate atten- 
tion may be required. 


Refer to the appropriate MVS publication for a description of 
media manager return and reason codes, and take corrective 
action based on the STATUS keyword. It may be necessary to 
replace the bad data set with a new data set containing the log 
data, and to update the BSDSs to reflect the new data set using 
the Change Log Inventory (DSNJU003) NEWLOG operation. 


For additional information about recovery from log failures, 
refer to Section 5 (Volume 2) of Administration Guide 


This message may also be issued as the result of a possible 
user error. If the data set name associated with the 

DSNAME = keyword is missing, and the STATUS = keyword dis- 
plays a value of '00180408' then the site is using dual logging 
but only one set of active log data sets are defined in the BSDS. 
To resolve this condition, do one of the following: 


* Define a second set of active fog data sets using AMS (if 
they are not defined already), and update the BSDS log 
inventory using the Change Log Inventory (DSNJU003) 
NEWLOG operation. 


e Reset the log parameters ZPARM to indicate single logging. 


DSNJ1071 READ ERROR ON BSDS DSNAME =... ERROR 


STATUS =... 


Explanation: The log manager encountered an error while 
reading the specified bootstrap data set. Error Status contains 
the VSAM return and feedback codes. It is a 2-byte field with 
the first byte containing the hexadecimal return code and the 
second containing the hexadecimal feedback code. Refer to the 
appropriate MVS publication for a description of VSAM return 
and reason codes. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from BSDS or log failures. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJB006 


Dee eee End of Internal DB2 Information eee | 


System Action: If dual BSDSs are available, the log manager 
attempts to read from the other BSDS. If read from the second 
BSDS fails or if there is only one BSDS, an error code is 
returned to the log request that caused access to the BSDS. 


Operator Response: Notify the system programmer. 


System Programmer Response: It may be necessary to 
replace or repair the BSDS, depending on what conditions 
resulted from the read error. To replace a BSDS, first delete 
the bad BSDS, and then define the new BSDS with the same 
name and attributes. If a new name is used for the new BSDS, 
change the log startup JCL to specify the new BSDS name. 


DSNJ108I WRITE ERROR ON BSDS DSNAME -... ERROR 


STATUS =... 


Explanation: The log manager encountered an error while 
writing to the specified bootstrap data set. Error Status con- 
tains the VSAM return and feedback codes. It is a 2-byte field 
with the first containing the hexadecimal return code and the 
second containing the hexadecimal feedback code. Refer to the 
appropriate VSAM publication for a description of VSAM return 
and reason codes. 


| Internal DB2 Information pew ety 
This message is issued by the following CSECT(s): DSNJB006 


Ls End of internal DB2 Information ________| 


System Action: If dual BSDSs are available, the log manager 
enters single BSDS mode using the remaining good BSDS. Oth- 
erwise, an error code is returned to the log request that caused 
access to the BSDS. 


Operator Response: Notify the system programmer. 


System Programmer Response: if dual BSDS mode is being 
used, execute an offline access method services job to rename 
the error BSDS and define a new BSDS with the same name. 
Then enter the !og manager -RECOVER BSDS command to 
reestablish dual BSDS mode. 


lf dual BSDS mode is not being used, the DB2 subsystem must 
be shut down, and the BSDS must be recovered from a backup 
copy. To recover the BSDS, use the Change Log Inventory 
utility. 


DSNJ1091 OUT OF SPACE IN BSDS DSNAME -... 


Explanation: There is no more space in the specified bootstrap 
data set. The operation that encountered the out-of-space con- 
dition did not complete properly. 


[es <= Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJBO06 


ees End of Internal DB2 Information see 


System Action: If dual BSDSs are available, the log manager 
énters single BSDS mode using the remaining good BSDS. Oth- 
erwise, an error code is returned to the log request that caused 
access to the BSDS. 


Operator Response: Notify the system programmer. 


System Programmer Response: if dual BSDS mode is being 
used, execute an offline access method services job to rename 
the full BSDS and define a new, larger BSDS with the same 
name. Enter the DB2 -RECOVER BSDS command to reestablish 
dual BSDS mode. 


{f dual BSDS mode is not being used, the DB2 subsystem must 
be shut down and the BSDS recovered offline. In this case, 
execute the same access method services job mentioned above 
to rename the full data set and define a larger data set. Next, 
execute an access method services REPRO job to copy the full 
BSDS into the new BSDS. 


DSNJ110E LAST COPYn ACTIVE LOG DATA SET IS nnn 


PERCENT FULL 


Explanation: This message is issued when the last available 
active log data set is 75% full, and is reissued after each addi- 
tional 5% of the data set space is filled. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNJW107 


te ee End of Internal DB2 Information eae a 


DSNJ1091 — DSNJ112E 


System Action: Each time the message is issued, the off-load 
processing will be reattempted. If the situation is not corrected, 
the active log data space will fill to capacity, message 
DSNJ111E will be issued, and the DB2 online processing will 
hait. 


Operator Response: Perform a display request to ensure that 
there are no outstanding requests related to the log off-load 
process. Take the necessary action to satisfy any requests, and 
permit off-load to continue. If off-load fails to complete normally 
or cannot be initiated, notify the system programmer. 


System Programmer Response: Ejther correct the problem 
that is causing the off-load process to fail, or add more active 
log data sets. Note that the latter action requires DB2 to be 
down and the Change Log Inventory program to be run. 


Possible causes are: 


¢ Excessive logging. For example, too many users have 
requested !ogs at the same time or too many utilities have 
been specified LOG(YES). 


* Delayed or slow off-loading. For example, failure to mount 
archive volumes, incorrect replies to off-load messages, or 
slow device speeds. 


° Failing off-loads. See Operator Response. 


¢ Insufficient log space. See Operator Response. 


DSNJ111E OUT OF SPACE IN ACTIVE LOG DATA SETS 


Explanation: Due to delays in off-load processing, ai! available 
space in all active log data sets has been exhausted. DB2 
recovery logging cannot continue. 


[- 7 ~ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJW307 


eee sees End of Internal DB2 Information et | 


System Action: The DB2 log manager waits for an available 
data set. 


Operator Response: Perform a display request to ensure that 
there are no outstanding requests that are related to the log off- 
load process. Take the necessary action to satisfy any 
requests, and permit off-load to continue. 


System Programmer Response: Ifthe delay was caused by the 
lack of a resource required for off-load, the necessary resource 
must be made available to allow offload to complete and thus 
permit logging to proceed. For additional information on 
recovery from this condition, refer to the discussion on DB2 
system resource failures and active log failures in Section 5 
(Volume 2) of Administration Guide 


INSUFFICIENT ACTIVE LOG DATA SETS DEFINED 
IN BSDS 


Explanation: There are not enough active log data sets defined 
in the BSDS to start DB2. This condition usually exists for one 
of the following reasons. 


DSNJ112E 


¢ Fewer than two data sets are defined for one of the active 
log copy sets. 


¢ DSN6LOGP specified TWOACTV = YES in DB2 initialization 
parameters, but data sets for two copies of active log are 
not defined in BSDS. 
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DSNJ113E — DSNJ117I 


| Internal DB2 Information ~ eee | 
This message is issued by the following CSECT(s): DSNJW006 


[oo End of Internal DB2 Information ee 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Use the Change Log Inventory 
utility to make the number of active log data sets defined in the 
BSDS consistent with the parameters specified on DSN6LOGP. 
Restart DB2. 


DSNJ113E RBA log-rba X NOT IN ANY ACTIVE OR ARCHIVE 
LOG DATA SET. CONNECTION-ID = aaaaaaaa, 


CORRELATION-ID = aaaaaaaa 


Explanation: The log manager has been requested to read the 
log record starting at this relative byte address (RBA). 
However, this log record cannot be found in any active or 
archive log data set. The connection and correlation !Ds iden- 
tify the user or application that encountered the problem. Refer 
to Section 5 (Volume 2) of Administration Guide for information 
about recovery from log failures. 


fc on Internal DB2 Information oe Fe al 
This message is issued by the following CSECT(s): DSNJRO03 


Meee End of Internal DB2 Information pee ee | 


System Action: Depending upon what log record is being read 
and why, the log manager may abend with a reason code of 
'00D1032A'. 


Operator Response: Copy the RBA value, and notify the 
system programmer. 


System Programmer Response: Probable user error. Most 
likely, the archive log data set that contained the requested 
RBA has been deleted from the bootstrap data set (BSDS) by 
the Change Log Inventory utility. Locate the output from an old 
Print Log Map run, and identify the data set that contains the 
missing RBA. If the data set has not been reused, run the 
Change Log Inventory utility to add this data set back into the 
inventory of log data sets. Restart DB2. 


DSNJ114i ERROR ON ARCHIVE DATA SET, OFFLOAD CON- 
TINUING WITH ONLY ONE ARCHIVE DATA SET 


BEING GENERATED 


Explanation: An error occurred while accessing one of the 
archive data sets being created by off-load. Because the dual 
archive option is specified, off-load is continuing with the other 
archive data set. For the RBA range being offloaded, there is 
only one copy of archive instead of the usual two copies. 


oe — Internal DB2 Information 


This message is issued by the following CSECT(s): DSNJOFF1, 
DSNJOFF4 


Pe End of Internal DB2 Information ose ee, Vell 


System Action: Off-load produces a single archive data set. 


3-82 DB2 Messages and Codes 


System Programmer Response: A second copy of this archive 
log data set can be made, and the BSDS(s) can be updated with 
the Change Log Inventory utility. 


DSNJ115! OFFLOAD FAILED,.COULD NOT ALLOCATE AN 


ARCHIVE DATA SET 


Explanation: Off-load could not allocate an archive log data 
set. The off-load was not performed. This message is pre- 
ceded by message DSNJ103I. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJOFF1 


| eee ee End of Internal DB2 Information etd 


System Action: Off-load will be tried at a later time. 
Operator Response: Notify the system programmer. 


System Programmer Response: Review the error status infor- 
mation of message DSNJ103!. Correct the condition that caused 
the data set allocation to fail so that, on retry, the off-load can 
take place. 


DSNJ116! ERROR ATTEMPTING TO ADD ARCHIVE ENTRY 


TO BSDS 


Explanation: Off-load could not add an archive entry to the 
BSDS. The off-load is considered incomplete. The active log 
data set is not marked as reusable for new log data. This 
message is preceded by message DSNJ107!, DSNJ108I, or 
DSNJ 1091. 


| Internal DB2 Information ay tO 
This message is issued by the following CSECT(s): DSNJOFF3 


a End of Internal DB2 Information ae 


System Action: Off-load will be retried at a later time. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to the specific pre- 
ceding message for action. 


DSNJ117! INITIALIZATION ERROR READING BSDS 


DSNAME =......, ERROR STATUS =... 


Explanation: The log manager encountered an error during 
initialization reading from the specified bootstrap data set. 
Error status contains the VSAM return and feedback codes. It is 
a two byte field with the first containing the hexadecimal return 
code and the second byte containing the hexadecimal! feedback 
code. Refer to the appropriate VSAM publication for a 
description of VSAM return and reason codes. 


[ Internal DB2 Information ~~ se 
This message is issued by the following CSECT(s): DSNJB005 


ee End of Internal DB2 Information Kepeeeoee 


System Action: DB2 startup is terminated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine the cause of the 
read error using the VSAM error status information provided. 
Restart DB2. 


DSNJ118I LOG INITIALIZATION RECEIVED RETURN CODE 


nnn FROM xxxxxxxx MACRO 


Explanation: Log manager initialization received a bad return 
code from the named macro. 


| Internal DB2 Information ‘aoa oe wih 
This message is issued by the following CSECT(s): DSNJS001 


ee ee End of Interna! DB2 Information es: 


System Action: DB2 initialization is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the problem from 
the documentation on the named macro and return code. Then 
take appropriate steps, and restart the DB2 subsystem. 


DSNJ1191 BOOTSTRAP ACCESS INITIALIZATION PROC- 


ESSING FAILED 


Explanation: During log manager initialization, the bootstrap 
data set access function was unable to complete its initializa- 
tion process. Refer to Section 5 (Volume 2) of Administration 
Guide for information about recovery from BSDS or log failures. 


es internal DB2 Information a | 
This message is issued by the following CSECT(s): DSNJS001 


on eee End of Internal DB2 Information ne, 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error have preceded this message. 
Refer to the specific message(s) for error analysis and the 
appropriate action to take. 


DSNJ1201 DUAL BSDS DATA SETS HAVE UNEQUAL 
TIMESTAMPS, BSDS1 SYSTEM —..., UTILITY =..., 


BSDS2 SYSTEM =..., UTILITY =... 


Explanation: When the log manager was initialized, the time 
stamps of the dual bootstrap data sets (BSDS) did not agree. 
The time stamps from the system and from the Change Log 
Inventory utility are shown for each BSDS. The time stamps 
have the format yy.ddd hh:mmiss.th. 


| : internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJB005 


RetZ eet End of Internal DB2 Information eee ee 


System Action: DB2 startup is terminated. 


Operator Response: Notify the system programmer, so oper- 
ating procedures can be reviewed. 


DSNJ1181 — DSNJ123! 


System Programmer Response: Run the Print Log Map utility 
against each BSDS. From the output, determine which data set 
is obsolete, delete it, define a replacement for it, and copy the 
remaining BSDS to the replacement. 


If output from the Print Log Map utility for both data sets is 
similar, delete the data set with the oldest time stamp, and copy 
the data set with the most recent time stamp. 


DSNJ1211 LOG MANAGER ENCOUNTERED AN ERROR 


READING THE JFCB. DONAME = nnnnnnnn 


Explanation: During log manager initialization (if dual BSDS 
data sets are specified), the job file control block (JFCB) in MVS 
is read to obtain the data set names associated with DDNAME 
BSDS1 and BSDS2. This error is caused by a missing DD state- 
ment. , 


it Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJBO06 


{End of Internal DB2 tntormation ___| 


System Action: DB2 is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Ensure that a DD statement 
exists in the DB2 startup procedure for DDNAME BSDS1. !f dual 
BSDS data sets are used, ensure that a DD statement also 
exists in the DB2 startup procedure for DDNAME BSDS2. 


DSNJ1221 DUAL BSDS DATA SETS ARE OUT OF SYNCHRO- 


NIZATION 


Explanation: During log manager initialization, the dual BSDS 
data sets were found to differ in content. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJBO05 


feb S teres End of Internal DB2 Information a) 


System Action: DB2 startup is terminated. 


Operator Response: Notify the system programmer to allow 
operating procedures to be reviewed. 


System Programmer Response: Run the Print Log Map utility 
against each BSDS to determine which data set was last used 
as copy 1. Delete the copy 2 data set, define a replacement for 
the deleted data set, and copy the remaining BSDS to the 
replacement. 


DSNJ1231 CHANGE LOG INVENTORY FAILURE DETECTED 


Explanation: During log manager initialization, the BSDS data 
set was found to have been incompletely processed by the 
Change Log Inventory utility. 


ee Internal DB2 Information —— 
This message is issued by the following CSECT(s): DSNJB005 


eee End of Internal DB2 Information _ 


System Action: DB2 startup is terminated. 
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DSNJ1241 — DSNJ128I 


System Programmer Response: Run the Print Log Map utility 
to determine what operation against the BSDS did not com- 
plete. Run the Change Log Inventory utility against the BSDS(s) 
to allow any unfinished processing to be completed. 


DSNJ124! OFFLOAD OF ACTIVE LOG SUSPENDED FROM 


RBA xxxxxx TO RBA xxxxxx DUE TO I/O ERROR 


Explanation: During off-load, an unrecoverable I/O error was 
encountered on an active log data set. The data set experi- 
encing the error is marked unusable, and no further logging is 
done to that data set. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJOFF4 


Uae eee End of internal DB2 Information a 


System Action: Active log data sets continue to be off-loaded 
as they become full. 


Operator Response: Notify the system programmer to allow 
recovery actions to be initiated. 


System Programmer Response: Recover the data manually 
from the data set, copy it to an archive data set, run the Change 
Log Inventory utility to make the new archive data set available 
to the DB2, and remove the error-prone active log data set from 
DB2 by using the Change Log Inventory utility. 


DSNJ1251 ERROR DUMPING BSDS, OFFLOAD CONTINUING 


WITHOUT PRODUCING THE BSDS DUMP 


Explanation: A read error occurred while dumping the BSDS 


_ data set during the off-load process. The data set is not 


produced, but the off-load process continues. The volume con- 
taining the off-loaded data set does not contain a BSDS for 
recovery use. 


[ Internal DB2 Information | 
This message ts issued by the following CSECT(s): DSNJOFF3 


[ete ee aae End of Internal DB2 Information eae 


System Action: The system continues the off-load process 
without producing a dump of the bootstrap data set. 


DSNJ1261 BSDS ERROR FORCED SINGLE BSDS MODE 


Explanation: The log manager encountered an I/O error ora 
VSAM logical error on a bootstrap data set. This message is 
preceded by message DSNJ107I or DSNJ108!. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJB0O1 


| End of Internal DB2 Information | 


System Action: The log manager enters single BSDS mode 
using the remaining BSDS. 


Operator Response: Notify the system programmer. 


System Programmer Response: Execute an offline access 
method services job to rename the error BSDS and define a 
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new BSDS with the same name. Then enter the log manager 
-RECOVER BSDS command to reestablish dual BSDS mode. 


DSNJ1271 SYSTEM TIMESTAMP FOR BSDS-... 


Explanation: When the log manager is initialized, the system 
time stamp for the bootstrap data sets (BSDS) is displayed. The 
time stamp is of the format yy.ddd hh:mm:ss.th. This time 
stamp should be close to the last time at which this subsystem 
was Stopped. If not, then it may indicate a restart is being 
attempted with the wrong BSDS. 


oo Internal DB2 Information —— | 
This message is issued by the following CSECT(s): DSNJB005 


er ee End of internal DB2 Information ee | 


System Action: DB2 startup continues. 


Operator Response: if the time displayed does not appear to 
be close to the time this subsystem was last stopped, contact 
the system programmer. 


System Programmer Response: [f you cannot expiain the 
apparent time discrepancy, cancel the subsystem. From the 
startup procedure for the subsystem services address space, 
determine the data set names of the bootstrap data sets and 
run the Print Log Map utility. Check whether the active and 
archive log data sets all belong to this subsystem. If not, then 
change the startup procedure for the subsystem services 
address space to use the correct bootstrap data sets. 


DSNJ128!1 LOG OFF-LOAD TASK FAILED FOR ACTIVE LOG 


Explanation: The off-load task abended while attempting to 
offload the relative byte address (RBA) range in active log data 
set 'nnnnn'. 


[ = Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJOFF6 


Ets. oes End of Internal DB2 Information ee eee hd 


System Action: The off-load task terminates and the archive 
data sets allocated to the off-load task are deallocated and 
deleted. The status of the active log data sets involved in the 
failed off-load processing remains set to 'not reusable’. 


The log off-load task will be reinitiated by one of several events. 
The most common are: 


¢ All the available space in the current active log data set has 
been used (normal case). 


¢ A DSNJ110E message is issued. 


¢ The master address space is started, but data in the active 
log has not been archived. 


e An I/O error occurs on the active log, which will force the 
system to truncate and off-load the active log data set, and 
switch to a new active log data set. 


Operator Response: This message is the result of an off-load 
failure, and will be preceded by one or more DB2 messages (for 
example, DSNJO73!I) and/or MVS ABEND messages (for 
example, IECO30I, 1ECO311, IECO32I). If DB2 is operating with 
restricted active log resources (see message DSNJ110E), 
quiesce the system to restrict logging activity until the ABEND 





or the DSNJ110E condition can be resolved. Notify the system 
programmer. 


System Programmer Response: This message is the result of 
an off-load failure, and will be preceded by one or more DB2 
messages (for example, DSNJ073!) and/or MVS ABEND mes- 
sages (for example, IEC030I, IEC0311 IEC032I). Investigate and 
correct the cause of the ABEND before the off-load is attempted 
again by DB2. 


Problem Determination: This message is the result of an 
offload ABEND and will be preceded by one or more DB2 mes- 
sages and/or MVS ABEND messages. See the documentation 
for the associated DB2 and/or MVS messages to formulate a 
course of corrective action. Use the Print Log Map Utility 
(DSNJU004) to print the BSDS (both copies if running in dual 
mode), and then use the DSNJU004 output to determine the 
current status of the active and archive log data sets. 


This message can be generated for a variety of reasons. 
However, the most likely are: 


¢ Archive log data set allocation errors. Refer to the text for 
message DSNJ103I for corrective action. 


¢ The size of the archive log data set is too small to contain 
the active log data set(s) during offload processing. Al! sec- 
ondary space allocations have been used. This condition is 
normally accompanied by MVS ABEND message IEC030I. 


¢ Ali available space on the DASD volume(s) to which the 
archive data set is being written has been exhausted. This 
condition is normally accompanied by MVS ABEND 
message !IEC032l. 


e The primary space allocation for the archive log data set 
(as specified in ZPARMs) is too large to allocate to any 
available online DASD device. This condition is normally 
accompanied by MVS ABEND message IEC032I. 


DSNJ1291 END OF log-rba eol-rba X COULD NOT BE FOUND 
IN ANY ACTIVE LOG DATA SET HIGHEST RBA 


FOUND WAS hi-rba X 


Explanation: The log manager has been requested to find 
‘eol-rba', the log record which has been recorded in the boot- 
strap data set (BSDS) as the highest RBA written. This RBA 
cannot be found in any active log data set. The highest RBA 
which could be found in any active data set was 'hi-rba'. 


| ~ Internal DB2 Information = | 
This message is issued by the following CSECT(s): DSNJW009 


ananersee ees End of internal DB2 Information pee pel 


System Action: DB2 startup processing is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Most likely, the active log data 
set containing the requested RBA has been deleted from the 
BSDS by the Change Log Inventory utility. If the data set has 
not been reused, run the Change Log Inventory utility to add 
this data set back into the BSDS. Restart DB2. 


If the data set is not available, a conditional restart must be per- 
formed to either truncate the log prior to the RBA value of the 
missing data set, or to cold start at a higher RBA value. Refer 
to Section 5 (Volume 2) of Administration Guide for more infor- 
mation. 


| 
| 


| 


| 
| 


DSNJ1291 — DSNJ200I 


DSNJ130I ICF CATALOG NAME IN BSDS DOES NOT AGREE 
WITH DSNZPARM. BSDS CATALOG 
NAME = name, DSNZPARM CATALOG 


NAME = name 


Explanation: The ICF catalog name defined in DSNZPARM 
does not agree with the name contained in the bootstrap data 
set (BSDS). 


Ne Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJBO05 


[ite tae End of internal DB2 Information ee ears | 


System Action: DB2 startup is abended. 
User Response: Notify the system programmer. 


Operator Response: If you attempt to start the DB2 subsystem, 
you will receive this same message and abnormal termination 
will result until the problem is resotved. 


System Programmer Response: Change the ICF catalog name 
in the BSDS to agree with the name defined in DSNZPARM 
during DB2 initialization. To change the ICF catalog name in 
the BSDS, use the BSDS Change Log Utility program with the 
NEWCAT control statement. 


Problem Determination: During Log Manager initialization, the 
ICF catalog name defined in DSNZPARM is compared to the 
catalog name in the BSDS to ensure that the catalog name used 
by the Log Manager during DB2 processing is correct. These 
names were found not to be the same. 


DSNJ1391 LOG OFFLOAD TASK ENDED 


Explanation: Processing of the active log offload ended. 


| Internal DB2 Information = | 
This message is issued by the following CSECTS(s): DSNJOFF1 


ties Se Sree cat End of Internal DB2 Information ee eee a 


System Action: This message is written to the MVS console. 


Operator Response: This message does not guarantee that the 
offload completed without errors. Check the console log and 
task messages to review the execution of the offload task to 
determine whether any abnormal events occurred during the 
offload. 


DSNJ2001 csect-name xxxxxxxx UTILITY PROCESSING COM- 


PLETED SUCCESSFULLY 


Exptanation: The control section 'csect-name' successfully 
completed the 'xxxxxxxx' utility. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNJU003, 
DSNJU004 


ar End of Internal DB2 Information eer 


System Action: DB2 writes this message to the SYSPRINT data 
set, not to a console. 
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DSNJ201I — DSNJ209I 


DSNJ2011 csect-name xxxxxxxx UTILITY PROCESSING WAS 


UNSUCCESSFUL 


Explanation: The control section ‘csect-name' was unable to 
successfully complete processing of 'xxxxxxxx' utility. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNJU003, 
DSNJU004 


eee eee End of internal DB2 Information TE 


System Action: The current utility is terminated. DB2 writes 
this message to the SYSPRINT data set, not to a console. 


User Response: Review other messages produced by the 
utility to determine the appropriate action to be taken. 


DSNJ202I _=csect-name INSUFFICIENT VIRTUAL STORAGE 


AVAILABLE TO CONTINUE WITH UTILITY 


Explanation: A GETMAIN macro instruction has failed, because 
virtual storage is unavailable for the job-step. 


~~ Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): DSNJU001, 
DSNJU002, DSNJU003 


[he cea aks End of Internal DB2 Information See 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Rerun the utility after providing a larger 
virtual storage allocation for the job-step. 


DSNJ2031 XXXXXXXX OPERATION IS INVALID 


Explanation: The user entered a utility control statement oper- 
ation of 'xxxxxxxx' that is invalid. 


| Internal DB2 Information — 
This message is issued by the following CSECT(s): DSNJU001 


[| seEnd of internal DB2 Information __ 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement, and rerun the 
utility. 


DSNJ204E = xxxxxxxx PARAMETER IS INVALID 


Explanation: The user specified a utility control statement 
parameter of 'xxxxxxxx' that is invalid. 


[ no Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNJU001 


rere ree toes End of Internal DB2 Information Bee eee 
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System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement, and rerun the 
utility. 


DSNJ205) 0 Xxxxxxxxx PARAMETER HAS NO ARGUMENT 


Explanation: 'xxxxxxxx' contains the name of a parameter that 
requires an argument. 


| Internal DB2 information ea | 
This message is issued by the following CSECT(s): DSNJU001 


[ee ot End of Internal DB2 Information eee 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Specify an argument for the identified param- 
eter and then rerun the utility. 


DSNJ2061 XXXXXXXX PARAMETER REQUIRES NO ARGUMENT 


Explanation: 'xxxxxxxx' contains the name of the parameter 
that has been incorrectly followed by an = symbol. 


| Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNJU001 


een End of internal DB2 Information ees eh 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement, and rerun the 
utility. 


DSNJ2071 ~=—scsect-name PARAMETERS INCONSISTENT WITH 


SPECIFIED OPERATION 


Explanation: The user has specified utility control statement 
parameters that are inconsistent with the specified utility opera- 
tion. 


: Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNJUO01, 
DSNJU103, DSNJU203 


(ies orn es End of Internal DB2 Information eee 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement, and rerun the 
utility. 


DSNJ2091 ENDRBA VALUE MUST BE GREATER THAN 


STARTRBA VALUE 


Explanation: The 'STARTRBA' and 'ENDRBA' parameters 
specify an RBA range. Hence, the ENDRBA value must be 
greater than the STARTRBA value. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJU103 


are End of Internal DB2 Information eee | 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement, and rerun the 
utility. 


DSNJ2101 OLD ICF CATALOG NAME = oldname, NEW 


CATALOG NAME = newname 


Explanation: Change Log Inventory utility processing for the 
NEWCAT control statement has completed successfully. 


oldname_ Either: 
e The name of the prior ICF catalog 
e 'NULL' if no prior name existed. 


newname 
The name of the ICF catalog defined by the 
VSAMCAT keyword. 


<= internal DB2 Information oe ewe ot 
This message is issued by the following CSECT(s): DSNJU003 


ie End of Internal DB2 Information eee a! | 


DSNJ2111 UNEXPECTED END OF DATA ON SYSIN DATA SET 


Explanation: Additional control statements were expected but 
could not be found. 


oo. . Internal DB2 information | 


This message is issued by the following CSECT(s): DSNJU001, 
DSNJU003 


_————o End of Internal DB2 Information el 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement(s), and rerun 
the utility. 


csect-name ERROR RETURNED FROM BSDS 
READ, RPLERRCD = yy, DONAME = xxxxxxxx 


Explanation: A VSAM GET was issued that resulted in a 
nonzero return code. ‘yy' contains the error code returned by 
VSAM. 'xxxxxxxx' contains the ddname of the BSDS encount- 
ering the error. 


DSNJ212I 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNJU002, 
DSNJU102 


[Se ee End of internal DB2 Information ee 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


DSNJ2101 — DSNJ216I 


User Response: The action taken is dictated by the return 
code. The BSDS may have to be recovered by use of a backup 
copy. 


DSNJ2131 csect-name ERROR RETURNED FROM BSDS 


WRITE, RPLERRCD = yy, DDNAME = xxxxxxxx 


Explanation: A VSAM PUT was issued that resulted ina 
nonzero return code. 'yy' contains the error code returned by 
VSAM. 'xxxxxxxx' contains the ddname of the BSDS encount- 
ering the error. 


[ ae : Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNJU002, 
DSNJU102 


Nite 3 ae oe End of Internal DB2 Information eek es tn 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: The action to be taken is dictated by the 
return code. The BSDS may have to be recovered by use of a 
backup copy. 


DSNJ214l SPECIFIED DSNAME ALREADY EXISTS IN BSDS, 


DDNAME = xxxxxxxx 


Explanation: The user attempted a NEWLOG operation with a 
data set name that already exists in the BSDS. An entry is 
never made in a BSDS if the specified DSNAME currently exists 
in either the active or archive records of that BSDS. 'xxxxxxxx' 
contains the ddname of the subject BSDS. 


[ <== ~~ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJU103 


ees End of Internal DB2 Information Boe ee ea 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Either correct the contro! statement and rerun 
the utility, or delete the existing DSNAME from the BSDS and 
rerun the utility. 


DSNJ216! BSDS ACTIVE LOG DATA SET RECORD IS FULL, 


DDNAME = xxxxxxxx 


Explanation: The maximum number of active log data sets is 
fixed. No further entries can be inserted after the maximum has 
been reached. 'xxxxxxxx' contains the ddname of the subject 
BSDS. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJU103 


ere ee 2 End of Internal DB2 Information ogee 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Run the Print Log Map utility to determine the 
current status of the BSDS. Subsequent actions can then be 
formulated, depending upon the status of the BSDS. 


DB2 Messages 3-87 








DSNJ2171 — DSNJ2211 


DSNJ2171 SPECIFIED DSNAME DOES NOT EXIST IN BSDS, 


DDNAME = xxxxxxxx 


Explanation: The DELETE operation specifies a DSNAME that 
cannot be found in the BSDS. 'xxxxxxxx' contains the ddname 
of the subject BSDS. 


[ Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNJU203 


[Soren eee, End of internal DB2 Information eS 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement, and rerun the 
utility. 


DSNJ218I SPECIFIED VOLUME DOES NOT EXIST IN BSDS, 


DDNAME = xxxxxxxx 


Explanation: The DELETE operation specifies a COPY1VOL or 
COPY2VOL argument that cannot be found in the BSDS. 
"Xxxxxxxx' contains the ddname of the subject BSDS. 


i. Internal DB2 Information ee ot 
This message is issued by the following CSECT(s): DSNJU203 


——— End of Internal DB2 Information Seer ao 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the control statement, and rerun the 
utility. 


DSNJ2191 csect-name OPEN ERROR, DDNAME = xxxxxxxx 


Explanation: An error occurred when the control section 
(CSECT) 'csect-name' tried to open a data set named 
"XXXXXXXX!. 


This error can be caused by a number of different conditions. 
The most probable conditions are: 


1. The ddname of the SYSPRINT, SYSIN, or SYSUT1 data set 
was not specified in the user’s job control language (JCL). 


2. The DB2 subsystem is currently executing. 


3. The bootstrap data set (BSDS) has been allocated by 
another job with a disposition (DISP) that conflicts with the 
DISP specified in the user’s JCL. 


4. The data set associated with 'xxxxxxxx' is already open, 
possibly due to an earlier system abend. 


5. The user is not authorized to access the data set associated 
with 'xxxxxxxx'! 


6. Insufficient virtual storage is available to perform the OPEN 
command. 


7. The catalog indicates that the data set associated with 
"XXXXXXxX' has an invalid physical record size. 
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| 7 Internal DB2 Information 


This message is issued by the following CSECT(s): DSNJU001, 
DSNJU002 


ee End of Internal DB2 Information ga 


System Action: The current utility is terminated. 


DB2 writes this message to the SYSPRINT data set, not toa 
console. 


User Response: The user’s action depends on the condition 
that caused the OPEN error. The following is a list of appro- 
priate actions corresponding to the conditions listed in the 
Explanation: 


1. Provide the missing data definition (DD) statements, and 
then rerun the utility. Refer to Command and Utility Refer- 
ence for details concerning the required DD statements. 


2. Wait until the DB2 subsystem is inactive before running the 
utility again because the Log utility cannot execute while 
the DB2 subsystem is active. 


3. Correct the disposition conflict and then rerun the utility. 


4. Submit an access method services (IDCAMS) VERIFY job 
against the data set associated with 'xxxxxxxx'. Rerun the 
Log utility job. 


5. In the case of an authorization failure, a separate message 
is usually generated from the authorization facility (RACF, 
for example). Investigate the authorization messages and 
obtain the proper authorization before running the utility 
again. 


6. Insufficient virtual storage is usually accompanied by a sep- 
arate error from the MVS operating system. Increase the 
REGION size on the JCL job step and rerun the utility. 


7. Contact the system programmer. 


DSNJ2201 BSDS IN CREATE MODE. NO DATA TO MAP, 


DDNAME = nnnnnnnn 


Explanation: The Print Log Map utility found the BSDS to be in 
create mode, so it cannot contain data to map. 'xxxxxxxx' con- 
tains the ddname of the data set. 


| internal DB2 information 
This message is issued by the following CSECT(s): DSNJU004 


{| _s End of Internal DB2 Information ____———_| 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the JCL so that a non-null data set 
can be processed. 


DSNJ2211 PREVIOUS ERROR CAUSED xxxxxxxx OPERATION 


TO BE BYPASSED 


Explanation: DB2 encountered errors while processing a 
utility. These errors subsequently caused 'xxxxxxxx' to be 
bypassed. 


This message is a warning only and is displayed after mes- 
sages that specify the error or errors that caused the utility 
operation to abend. Note that the error or errors may not be 
associated with the current 'xxxxxxxx' operation; rather, under 


Log utility processing, a significant error in any operation 
causes the control statements for this and any subsequent 
operations to be checked for syntax only. BSDS updates do not 
occur for any operation specified in this message. 


| Internal DB2 Information ~~ Seer 
This message is issued by the following CSECT(s): DSNJU003 


exe te ey End of Internal DB2 Information Se ree 


System Action: The Log utility continues to process. However, 
for this and all subsequent operations, the bootstrap data set 
(BSDS) is not updated and the utility only checks the syntax of 
the control statements. 


DB2 writes this message to the SYSPRINT data set, not to a 
console. 


User Response: Consult the previous messages and correct 
any errors that caused this message to be generated. 
Resubmit the Log utility job for all operations that have been 
bypassed. 


DSNJ2221 INVALID SPECIFICATION OF xxxx PARAMETER 


ARGUMENT 


Explanation: You specified the parameter 'xxxx'. This param- 
eter is not valid for the argument. 


fo Internal DB2 information 


This message is issued by the following CSECT(s): 


DSNJU103 DSNJUO03 DSNJU403 
DSNJU503 


reeee eee End of Internal DB2 Information eee | 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the parameter argument on the 
control statement, and rerun the utility. 


DSNJ223! xxxx PARAMETER ARGUMENT EXCEEDS 


MAXIMUM ALLOWABLE LENGTH 


Explanation: 'xxxx' specifies the name of the parameter 
whose argument value exceeded the maximum length allowed. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJU001 


Thee teeta End of Internal DB2 Information ee oe 2 il 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Correct the parameter argument on the 
control statement, and rerun the utility. 


DSNJ2241 = =xxxx PARAMETER APPEARS TOO OFTEN 


Explanation: 'xxxx' specifies the name of the parameter that 
has been specified more than once on the same control state- 
ment. 


DSNJ2221 — DSNJ227!1 


an Internal DB2 information i 
This message is issued by the following CSECT(s): DSNJU001 


a End of Internal DB2 Information ee eee 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Remove the redundant parameter, and rerun 
the utility. 


DSNJ225| xxxx OPERATION SUCCESSFULLY COMPLETED 


Explanation: The 'xxxx' specified in the message identifies 
the name of the Change Log Inventory utility operation that has 
been successfully completed. 


| ; Internal DB2 information SS | 
This message is issued by the following CSECT(s): DSNJU003 


(es eee End of Internal DB2 Information es 


System Action: This message is written to the SYSPRINT data 
set, not to a console. 


DSNJ2261 SPECIFIED VOLUME ALREADY EXISTS IN BSDS, 


DDNAME = xxxxxxx 


Explanation: The specified volume currently exists in the 
archive log records of the BSDS. 'xxxxxxxx' specifies the 
ddname of the subject BSDS. 


So ae Internal DB2 information ee 
This message is issued by the following CSECT(s): DSNJU103 


ere eee End of Internal DB2 Information etek | 


System Action: The current utility is terminated. This message 
is written to the SYSPRINT data set, not to a console. 


User Response: Either correct the parameter argument on the 
control statement, or delete the specified volume and rerun the 
utility. 


DSNJ2271 NO SPACE AVAILABLE IN BSDS FOR ADDITIONAL 


ARCHIVE VOLUME ENTRIES, DDNAME = xxxxxxxx 


Explanation: The maximum number of archive volumes has 
been exceeded, and no more space is available for volume 
entries in the copy specified. 


ee are Internal DB2 Information = A 
This message is issued by the following CSECT(s): DSNJU103 


esos End of internal DB2 Information _ sd 


System Action: The current utility is terminated. 


User Response: Delete some ofthe archive entries in the 
specified copy number, and rerun the utility. 
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DSNJ228! — DSNJ235! 


DSNJ228! LOG DEALLOCATION ERROR DSNAME = dsname, 


ERROR STATUS = eeeeiiii 


Explanation: The log manager encountered an error when 
trying to dynamically deallocate the data set. Error status is the 
error reason code returned by MVS dynamic allocation. 


| Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNJDS01 


{ End of Internal DB2 Information poe en 


System Action: Log manager processing continues. 
Operator Response: Notify the system programmer. 


System Programmer Response: The error status portion of this 
message contains the 2-byte error code (S99ERROR) foliowed 
by the 2-byte information code (S99INFO) from the SVC request 
block. Refer to the appropriate MVS publication for a 
description of these codes. 


DSNJ2301 LOG OFFLOAD SUBCOMPONENT INITIALIZATION 


PROCESSING FAILED 


Explanation: During log manager initialization, the offload 
function was unable to complete its initialization process. 


ones fae ao ee Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJS001 


a End of Internal DB2 Information eee | 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
actions to take. 


DSNJ2311 LOG COMMAND INITIALIZATION PROCESSING 


FAILED 


Explanation: During log manager initialization, the log 
command function was unable to complete its initialization 
process. 


| ~—_ Internal DB2 Information " al 
This message is issued by the following CSECT(s): DSNJS001 


[| s End of Internal DB2 Information _____ 


System Action: DB2 startup is terminated. 


Operator Response: The rest of subsystem termination will 
direct the actions you should take. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 
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This message will be of interest to the IBM support center when 
the problem is described. 


DSNJ232! OUTPUT DATA SET CONTROL INITIALIZATION 


PROCESSING FAILED 


Explanation: During log manager initialization, the output data 
set contro! function was unable to complete its initialization 
process. 


[ : ~~ _ Internal DB2 Information ~— ve 1. ear 
This message is issued by the following CSECT(s): DSNJS001 


Be eee End of Internal DB2 Information eee 


System Action: DB2 startup is terminated. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message for error analysis and the appropriate 
action to take. 


This message will be of interest to the IBM support center when 
the problem is described. 


DSNJ2331 ARCHIVE LOG READ INITIALIZATION PROC- 


ESSING FAILED 


Explanation: During log manager initialization, the archive log 
read function was unable to complete its initialization process. 


[ ay internal DB2 Information ~~ 
This message is issued by the following CSECT(s): DSNJS001 


Pee see End of Internal DB2 Information eae 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 


DSNJ2351 OUTPUT BUFFER WRITER INITIALIZATION PROC- 


ESSING FAILED 


Explanation: During log manager initialization, the output 
buffer writer function was unable to complete its initialization 
process. 


Internal DB2 Information = 
This message is issued by the following CSECT(s): DSNJS001 


ee End of Internal DB2 Information ee ice a a 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 


DSNJ236! BOOTSTRAP ACCESS TERMINATION PROC- 


ESSING FAILED 


Explanation: During log manager termination, the bootstrap 
data set access function was unable to complete its termination 
process. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJT001 


aie) End of Internal DB2 Information ee 


System Action: Log manager shutdown continues to the next 
step. 


Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 


DSNJ238I LOG OFFLOAD TERMINATION PROCESSING 


FAILED 


Explanation: During log manager termination, the offload func- 
tion was unable to complete its termination process. 


[ Internal DB2 Information SS 
This message is issued by the following CSECT(s): DSNJT001 


es tea End of Internal DB2 Information eee 


System Action: Log manager shutdown continues to the next 
step. 


Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 


DSNJ2391 LOG COMMAND TERMINATION PROCESSING 


FAILED 


Explanation: During log manager termination, the log 
command function was unable to complete its termination 
process. 


fe a Internal DB2 Information ” | 
This message is issued by the following CSECT(s): DSNJT001 


Wea oe End of Internal DB2 Information eee 


System Action: Log manager shutdown continues to the next 
step. 


Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 


DSNJ2361 — DSNJ243! 


DSNJ2401 OUTPUT DATA SET CONTROL TERMINATION 


PROCESSING FAILED 


Explanation: During log manager termination, the output data 
set control function was unable to complete its termination 
process. 


i° 7. Internal DB2 Information oT 
This message is issued by the following CSECT(s): DSNJTO01 


[ie one End of Internal DB2 Information eee | 


System Action: The log manager shutdown continues to the 
next step. 


Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 


DSNJ2411 ARCHIVE LOG READ TERMINATION PROCESSING 


FAILED 


Explanation: During log manager termination, the archive log 
read function was unable to complete its termination process. 


: Internal DB2 Information ~ 
This message is issued by the following CSECT(s): DSNJT001 


{ End of Internal DB2 Information Say oe 


System Action: Log manager shutdown continues to the next 
step. 


Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 


DSNJ2431 OUTPUT BUFFER WRITER TERMINATION PROC- 


ESSING FAILED 


Explanation: During log. manager termination, the output buffer 
writer function was unable to complete its termination process. 


[ ~~ Internal DB2 Information —~ : “| 
This message is issued by the following CSECT(s): DSNJT001 


ee End of Internal DB2 Information Pee eaet ea 


System Action: Log manager shutdown continues to the next 
step. 


Operator Response: Notify the system programmer. 


System Programmer Response: One or more error messages 
describing the specific error preceded this message. Refer to 
the specific message(s) for error analysis and the appropriate 
action to take. 
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DSNJ244I — DSNJ302I 


LOG TERMINATION RECEIVED RETURN CODE 
nnn FROM xxxxxxxx MACRO 


DSNJ2441 


Explanation: Log manager termination was passed a bad 
return code from the named macro. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNJTO01 


[| End of Internal DB2 tnformation See ee es ll 


System Action: Log manager termination processing con- 
- tinues. 


Operator Response: Record the return code and macro-name, 
and notify the system programmer. 


System Programmer Response: This message is associated 
with a failure in the named macro. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DSNJ2451 CONDITIONAL RESTART RECORD INDICATES 


TRUNCATION AT RBA rrr. REPLY Y TO CON- 
TINUE, N TO CANCEL 


Explanation: The conditional restart control record in use indi- 
cates that the DB2 log be truncated at the specified RBA. 


| ——* internal DB2 Information 
This message is issued by the following CSECT(s): DSNJW306 


ae ee End of Internal DB2 Information eee, 


System Action: If 'Y', DB2 startup continues. !f 'N', DB2 
startup is terminated. 


Operator Response: Reply 'N' if the truncation is going to 
occur at an undesirable point. Notify system programmer. 
Reply 'Y' to continue the restart. 


System Programmer Response: Rerun the Change Log Inven- 
tory to modify the conditional restart record. 


DSNJ246! CONDITIONAL RESTART RECORD INDICATES 


COLD START AT RBArrr. REPLY Y TO CON- 
TINUE, N TO CANCEL 


Explanation: The conditional restart control record in use indi- 
cates that DB2 is to be cold started and that logging is to be 
begin at the specified RBA. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJW306 


Lo End of Internal DB2 Information _ 


System Action: if 'Y', DB2 startup continues. If 'N', DB2 
Startup is terminated. 


Operator Response: Reply 'N' if the truncation is going to 
occur at an undesirable point. Notify the system programmer. 
Reply 'Y' to continue the cold start. 


System Programmer Response: Rerun the Change Log Inven- 
tory to modify the conditional restart record. 
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DSNJ247E __—sccsect-name I/O ERROR DURING PROCESSING OF 


rrr RC = rc, REASON = reason 


Explanation: The |/O error occurred at record 'rrr'. 'rc' indi- 
cates the return code received from the I/O operation. 

‘reason' indicates the reason code received from the !/O oper- 
ation. 


if an return code '4' was received, this indicates that the log 
manager detected a problem. If an return code '8' was 
received, this indicates a VSAM error. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJW306 


(i eee End of Internal DB2 Information peta | 


System Action: DB2 startup terminates. 
Operator Response: Notify the system programmer. 


System Programmer Response: For a return code of '4', refer 
to Section 5 of Diagnosis Guide and Reference to isolate the 
problem area. For a return code of '8', execute an offline 
access method services job to determine the cause of the 
VSAM error. 


DSNJ3011 COMMAND FAILED, ERROR ACCESSING ONLINE 


BOOTSTRAP DATA SET 


Explanation: RECOVER BSDS command processing could not 
be performed, because an error occurred while reading from or 
writing to a bootstrap data set. 


a: Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNJC002 


| Ss End of Internal DB2 Information ______— 


System Action: The system continues in single BSDS mode. 


Operator Response: Inform the system programmer that the 
system is in single BSDS mode. 


System Programmer Response: Recovery action must be per- 
formed on the bootstrap data set before re-entering the 
command. 


DSNJ302I ALLOCATION ERROR ON REPLACEMENT BSDS 


DSNAME =... ERROR STATUS =... 


Explanation: The RECOVER BSDS command encountered an 
error while trying to dynamically allocate the specified data set. 
DSNAME is the data set name. Error Status is the.error code 
and information code returned by MVS dynamic allocation. 


os Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJC004 


[End of Internal DB2 Information ________—| 


System Action: Processing of the command is terminated. The 
system continues in single BSDS mode. 


Operator Response: Determine the cause of the error from the 
error status contained in the message, and correct the condi- 
tion. Then re-enter the -RECOVER BSDS command. 


System Programmer Response: The error status portion of this 
message contains the 2-byte error code (S99ERROR) followed 
by the 2-byte information code (S99INFO) from the SVC request 
block. Refer to the appropriate MVS publication for a 
description of these codes. 


DSNJ3031 WRITE ERROR ON REPLACEMENT BSDS 


DSNAME =... ERROR STATUS =... 


Explanation: The -RECOVER BSDS command encountered an 
error while attempting to write to the specified bootstrap data 
set. Error Status contains the VSAM return and feedback 
codes. It is a 2-byte field with the first containing the 
hexadecimal return code and the second containing the 
hexadecimal feedback code. 


System Action: Processing of the command is terminated. The 
system continues in single BSDS mode. 


[ ——< internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJC002 


tee ak oe op 8, End of Internal DB2 information ae S| 


Operator Response: Notify the system programmer. 


System Programmer Response: Execute an offline access 
method services job to delete or rename the replacement BSDS 
and define a new BSDS with the same name. Re-enter the log 
manager -RECOVER BSDS command to reestablish dual BSDS 
mode. 


DSNJ3041 ERROR CLOSING REPLACEMENT BSDS 


DSNAME =... ERROR STATUS =... 


Explanation: The -RECOVER BSDS command encountered an 
error while attempting to close the specified bootstrap data set. 
Error Status contains the VSAM return and feedback codes. It 
is a 2-byte field with the first containing the hexadecimal return 
code and the second containing the hexadecimal feedback 
code. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJC004 


[its oot ote? End of internal DB2 Information eee 


System Action: Processing of the command is terminated. The 
system continues in single BSDS mode. 


Operator Response: Notify the system programmer. 


System Programmer Response: Execute an offline access 
method services job to delete or rename the replacement BSDS 
and define a new BSDS with the same name. Re-enter the log 
manager -RECOVER BSDS command to reestablish dual BSDS 
mode. 


DSNJ3051 REPLACEMENT BSDS NOT EMPTY DSNAME ~... 


Explanation: The -RECOVER BSDS command was issued, but 
the replacement bootstrap data set was not empty; that is, it 
contained data. 


DSNJ303i — DSNJ404E 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJC004 


tht ee End of Internal DB2 Information ees | 


System Action: Processing of the command is terminated. DB2 
continues in single BSDS mode. 


Operator Response: Notify the system programmer. 


System Programmer Response: Execute an offline access 
method services job to delete or rename the error BSDS and 
define a new BSDS with the same name. Re-enter the log 
manager -RECOVER BSDS command to reestablish dual BSDS 
mode. 


DSNJ3061 DUAL BSDS MODE ALREADY ESTABLISHED 


Explanation: The -RECOVER BSDS command was issued, but 
DB2 was already in dual BSDS mode. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJC002 


aa End of Internal DB2 Information ee 


System Action: The command is ignored. 


DSNJ3071 LOG INITIALIZED IN SINGLE BSDS MODE 


Explanation: The -RECOVER BSDS command was issued, but 
the system was initialized in single BSDS mode. 


== Internal DB2 Information aan 
This message is issued by the following CSECT(s): DSNJC002 


leer eae End of internal DB2 Information _ 


System Action: Processing of the command is terminated. The 
system continues in single BSDS mode. 


DSNJ401! csect-name rrrr RECORD NOT FOUND 


Explanation: An attempt was made to read the record 'rrrr' by 
‘csect-name'. In so doing, the read routine (DSNJU01B) could 
not find the record. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): DSNRJFCK, 
DSNRJPCR 


Pec oe est End of Internal DB2 Information le oe ef 


System Action: Utility processing continues. This message is 
written to the SYSPRINT data set, not to a console. 


DSNJ404E keyword NOT ALLOWED FOR operation OPERA- 


TION 


Explanation: An invalid keyword was used during the opera- 
tion named ‘operation’. 
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DSNJ405E — DSNJ4111 


a Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJU503 


Pied oo! End of Internal DB2 Information eer: 


System Action: The current utility processing is terminated. 
This message is written to the SYSPRINT data set, not toa 
console. 


User Response: Correct the control statement and rerun the 
utility. 


DSNJ405E keyword! KEYWORD MUTUALLY EXCLUSIVE 


WITH keyword2 KEYWORD 


Explanation: ‘keyword1' and 'keyword2' are mutually exclu- 
sive and cannot appear on the same control statement. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNJU503 


B odnce sees es End of Internal DB2 Information ote eee 


System Action: The current utility processing is terminated. 
This message is written to the SYSPRINT data set, not toa 
console. 


User Response: Determine the extraneous keyword and 
remove it from the control statement. Rerun the utility. 


DSNJ406E EITHER keyword? KEYWORD OR keyword2 


KEYWORD MUST BE SPECIFIED 


Explanation: A required keyword was not used on the control 
statement. Use either 'keyword1' or 'keyword2' with the 
attempted control statement type. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNJU503 


(ec End of Interna! DB2 Information eeeoet ell 


System Action: The current utility processing is terminated. 
This message is written to the SYSPRINT data set, not to a 
console. 


User Response: Correct the control statement and rerun the 
utility. 


DSNJ407E_ _—csect-name NO VALID CHECKPOINT RBA FOUND 


Explanation: After completing its search through the Resource 
Manager Status Table and the checkpoint queue, no valid 
checkpoint RBA was found within the specified range. 


| — Internal DB2 Information 47 
This message is issued by the following CSECT(s): DSNRJFCK 


ee eee End of Interna! DB2 Information eee So 


System Action: The current utility processing is terminated. 
This message is written to the SYSPRINT data set, not toa 
console.. 
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User Response: The last 100 checkpoints are recorded in the 
BSDS, including the log STARTRBA and log ENDRBA of the 
checkpoint range. When either STARTRBA or ENDRBA are 
specified, Change Log Inventory attempts to locate a valid 
checkpoint in the range. In this case, Change Log Inventory 
was unsuccessful in finding a valid checkpoint. 


Do one of the following, as appropriate: 


e Ifno checkpoint exists in the STARTRBA/ENDRBA range, 
set STARTRBA=ENDRBA and cold start DB2. 


e If the ENDRBA is less than all recorded checkpoints or the 
STARTRBA is higher than all recorded checkpoints, then 
use DSN1LOGP to locate a valid checkpoint. Use 
DSN1LOGP SUMMARY(ONLY) option to find a valid check- 
point. Message DSN1153l is issued if any complete check- 
point is found. DSN1153l identifies the log RBA of the 
checkpoint. Update the CHKPTRBA parameter using the 
log RBA identified in DSN1153I and resubmit Change Log 
Inventory. 


DSNJ408! csect-name CHECKPOINT RBA FOUND, RBA = 


rba, TIME = time 


Explanation: After completing its search through the Resource 
Manager Status Table and the checkpoint queue, 'rba' was the 
most recent checkpoint RBA in the specified range and 'time' 
was the time of the checkpoint. 


i ee Internal DB2 Information ae aie ia 
This message is issued by the following CSECT(s): DSNRJFCK 


ee es End of Internal DB2 Information eae 


System Action: Utility processing continues. 


DSNJ410E _csect-name I/O ERROR DURING nnn PROCESSING 


OF yyy RECORD 


Explanation: An I/O error occurred during a READ or WRITE of 
arecord. 'nnn' is either READ or WRITE, depending on the 
operation. ‘yyy' represents a Conditional Restart Control, 
Checkpoint queue, or Resource Manager Status Table record. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNRJRCR, 
DSNRJFCK, DSNRJPCR 


(afta = ae End of Internal DB2 Information 2 eee 2 


System Action: The current utility processing is terminated. 
This message is written to the SYSPRINT data set, not toa 
console. 


User Response: Determine the cause of the I/O error based 
upon the error status information provided in messages 
DSNJ212E or DSNJ213E. 


csect-name CRESTART nnnn FOR CRCRID = 
yyyy, DDNAME = ddname 


DSNJ4111 


Explanation: A CRESTART request has just completed. 'nnnn' 
is either CREATE or CANCEL. ‘yyyy' is the restart control 
record hexadecimal identifier and 'ddname' is the BSDS data 
set (SYSUT1 or SYSUT2) associated with the request. 


f te Internal DB2 information | 
This message is issued by the following CSECT(s): DSNRJRCR 


ae End of Internal DB2 information eee ee 


System Action: Current utility processing continues. This 
message is written to the SYSPRINT data set, not to a console. 


User Response: Note the record identifier for future reference. 


DSNJ412E  csect-name RESTART CONTROL RECORD NOT 


FOUND IN BSDS 


Explanation: The CRESTART CANCEL keyword was specified 
but the conditional restart control record does not exist in the 
BSDS data set. 


| ~~ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNRJRCR 


| Ss End of Internal DB2 information 


System Action: Current utility processing is terminated. This 
message is written to the SYSPRINT data set, not to a console. 


User Response: CREATE the conditional restart control record 
prior to attempting the CANCEL function. 


DSNJ413E  csect-name INVALID LOG RANGE SCOPE OR 


CHECKPOINT SPECIFIED 


Explanation: The values specified thru the STARTRBA, 
ENDRBA, and CHKPTRBA keywords are invalid. 


pis Se Fs Internal DB2 Information 
This message is issued by the following CSECT(s): DSNRJRCR 


re End of Internal DB2 information esl 


System Action: Current utility processing is terminated. This 
message is written to the SYSPRINT data set, not to a console. 


User Response: Ensure that the log range values are correct 
and correspond to the other log range values either specified 
or defaulted. A valid log range is where STARTRBA is less than 
or equal to CHKPTRBA, and CHKPTRBA is less than ENDRBA. 
The STARTRBA most be less than or equal! to the ENDRBA. 


DSNJ4141 ~—csect-name COLD START WILL RESULT FROM 


THIS RESTART CONTROL RECORD. FORWARD 
AND BACKOUT SET TO NO. 


Explanation: STARTRBA and ENDRBA are equal. A cold start 
will result if this restart control record is used during DB2 
restart. No forward or backout processing will be performed. 


[ ae — Internal DB2 Information ~———_———— | 
This message is issued by the following CSECT(s): DSNRJRCR 


ae End of Internal DB2 Information a 


System Action: CRESTART processing continues. 


DSNJ412E — DSNJ4171 


User Response: No additional actions are required if a cold 
start of the system is desired. If a cold start is not desired, 
reissue the CRESTART and either CANCEL the current restart 
control record, or CREATE a new restart control record. 


DSNJ415E _csect-name ENDRBA = rba IS INVALID, MUST BE 


A MULTIPLE OF 4K 


Explanation: The specified ENDRBA at 'rba' is not a multiple 
of 4K. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNRJRCR 


Lo End of Internal DB2 Information oo eee 


System Action: CRESTART processing is terminated. 


User Response: Correct the ENDRBA value on the CRESTART 
statement and rerun the utility. 


DSNJ4161. WARNING - BSDS UTILITY TIMESTAMP MIS- 


MATCH DETECTED. PROCESSING CONTINUES. 


Explanation: As a result of a Change Log Inventory update, it 
was discovered that the SYSUT1 BSDS and SYSUT2 BSDS 
timestamps are unequal. Being unequal indicates the possi- 
bility of a BSDS mismaich. 


| ~ Internal DB2 Information a= aa, 
This message is issued by the following CSECT(s): DSNJU003 


Wise. End of Internal DB2 Information oe | 


System Action: Current utility processing continues. 


User Response: Run the Print Log Map utility against the 
SYSUT1 BSDS and SYSUT2 BSDS. Determine if each BSDS is 
current. |If each BSDS is current, this warning can be ignored. 
\f either BSDS is not current, delete the obsolete data set and 
define a replacement data set, then copy the current BSDS into 
the replacement data set. 


DSNJ417! REQUIRED xxxxxxxx PARAMETER FOR yyyyyyyy 


OPERATION IS MISSING 


Explanation: A required parameter 'xxxxxxxx' for a Log utility 
operation was missing from the Log utility control statement. 
The attempted operation is 'yyyyyyyy'. 


‘a Internal DB2 Information 5 ee 
This message is issued by the following CSECT(s): DSNJU003 


Diese End of Internal DB2 Information eee ae 


System Action: The Log utility 'yyyyyyyy' operation does not 
perform its function. All subsequent Log utility control state- 
ments are processed. A non-zero return code is issued by the 
utility. 

DB2 writes this message to the SYSPRINT data set, not toa 
console. 


User Response: Add the missing parameter to the control 
statements associated with the specified operation and rerun 
the utility. 
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DSNLOO1I — DSNLOO9I 





Distributed Data Facility (DSNL...) 


DSNLO011 DDF IS ALREADY STARTED 


Explanation: The distributed data facility (DDF) was already 
active when you issued -START DDF command. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLSSRC 


[oo End of Internal DB2 Information ees 


System Action: The issued command is not executed. 


DSNLO02! DDF IS ALREADY STOPPED 


Explanation: The distributed data facility (DDF) had already 
been stopped when the -STOP DDF command was issued. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNLSSRC 


lett eaaeest End of Interna! DB2 Information we tie gee 


System Action: The issued command is not executed. 


DSNLOO3I DDF IS STARTING 


Explanation: The distributed data facility (DDF) -START 
command is starting. 


i = =) Internal DB2 information a 
This message is issued by the following CSECT(s): DSNLSSST 


——— er End of Internal DB2 Information eee 


System Action: DB2 begins processing the -START DDF 
command. 


DSNLO04I DDF START COMPLETE LOCATION locname LU 


netname.luname 
Explanation: The distributed data facility (DDF) has started. 


The LOCATION of the DB2 subsystem. 
The fully qualified LU name for the DB2 
subsystem. 


locname 
netname.ltuname 


i a Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLSSST 


te eee End of Internal DB2 Information ee 


System Action: The DDF start up process has completed. 
However, it may fail for reasons specified by messages 
DSNLO131, DSNLO15!, DSNLO161, DSNLO171, DSNLO18!, DSNLO79l, 
or DSNL7085I. 


DSNLOO5I DDF IS STOPPING 


Explanation: The distributed data facility (DDF) -STOP 
command has been initiated. 


| Internal DB2 Information aa | 
This message is issued by the following CSECT(s): DSNLSSST 


[ees oseer, ot End of Internal DB2 Information sieved co 


System Action: The -STOP DDF command is initiated. 


DSNLOO6I DDF STOP COMPLETE 


Explanation: The distributed data facility (DDF) -STOP 
command has completed. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLSSST 


Roe End of Internal DB2 Information eres 


System Action: The DDF has stopped. 


DSNLOO7I 


Explanation: Abnormal termination of the distributed data 
facility (DDF) has started. 


DDF IS ABNORMALLY TERMINATING 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLSSST 


eres End of Internal DB2 Information eee et 


System Action: Abnormal termination of the DDF is starting. 


DSNLOO8i DDF ABNORMAL TERMINATION COMPLETE 


Explanation: Abnormal termination of the distributed data 
facility (DDF) has completed. 


eo ~—S internal DB2 Information a 
This message is issued by the following CSECT(s): DSNLSSST 


Mga ae ee End of internal DB2 Information Soe 


System Action: The DDF has stopped. 


DSNLOOS9I INVALID DDF THREAD logical-unit-of-work-id 


SPECIFIED 


Explanation: No distributed transaction with the specified 
"logical-unit-of-work-id' exists. 
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DSNLO010i — DSNLO15I 


i — Internal DB2 Information —- -S 
This message is issued by the following CSECT(s): DSNLCNCL 


Wess oe eee End of Internal DB2 Information EF ae eel 


System Action: The specified thread is not canceled. 


User Response: Determine the correct 
‘logical-unit-of-work-id' of the distributed thread that is to be 
canceled and then reissue the command. 


Problem Determination: Determine the correct value. The 
-DISPLAY THREAD command can be used to display all distrib- 
uted activity. 


DSNLO10I DDF THREAD logical-unit-of-work-id HAS BEEN 


CANCELED 


Explanation: The distributed data facility (DDF) thread 
'logical-unit-of-work-id' has been canceled. 


| oe Internal DB2 Information 
This message is issued by the following CSECT(s): DSNLCNCL 


eres End of Internal DB2 Information a eel 


System Action: The specified thread is canceled. 


DSNLO11! VTAM STOPPING DDF 


Explanation: The operator issued a HALT NET command to ter- 
minate VTAM. 


dae Internal DB2 Information _ fe ed 
This message is issued by the following CSECT(s): DSNLVPTE 


Uae End of Internal DB2 Information aepade 8S 


System Action: The distributed data facility (DDF) -STOP 
command is initiated. 


DSNLO12i. =VTAM TERMINATING DDF 


Explanation: The operator issued a HALT NET QUICK 
command or a HALT NET CANCEL command, or VTAM is termi- 
nating abnormally. This message can be issued any time after 
-START DDF and occurs when VTAM is stopped, which can 
occur prior to DDF termination. This message is not issued 
when DDF terminates normally. 


=< ~ Internal DB2 Information ~ : 
This message is issued by the following CSECT(s): DSNLVPTE 


a End of Internal DB2 Information Bee eel 


System Action: Termination of the distributed data facility is 
initiated. 
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DSNLO131 VTAM OPEN ACB FAILED ERROR = error-code 


Explanation: VTAM returned a non-zero return code after DB2 
invoked the OPEN ACB macro instruction during termination of 
the distributed data facility (DDF). VTAM return codes for OPEN 
error conditions are defined in ACF/VTAM Version 3 Program- 
ming. 


[ = internal DB2 Information ~ 7 os | 
This message is issued by the following CSECT(s): DSNLVACB 


Veet End of Interna! DB2 Information act esl 


System Action: Termination of the distributed data facility is 
initiated. 


Operator Response: Notify the system programmer. 
System Programmer Response: Determine the cause of the 


OPEN ACB failure, correct the error, and issue the -START ODF 
command. 


Problem Determination: Refer to ACF/VTAM Version 3 Pro- 
gramming for failure analysis during an OPEN macro instruc- 
tion. 


DSNLO14I VTAM CLOSE ACB FAILED ERROR = error-code 


Explanation: VTAM returned a non-zero return code after DB2 
invoked the CLOSE ACB macro instruction during termination of 
the distributed data facility (DDF). VTAM return codes for 
CLOSE error conditions are defined in ACF/VTAM Version 3 
Programming. 


| Saar internal DB2 information eS is | 
This message is issued by the following CSECT(s): DSNLVACB 


———— End of Internal DB2 Information ee Spo> a | 


System Action: Termination of DDF continues. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the cause of the 
failure, fix the error condition, and then issue the -START DDF 
command. 


Problem Determination: Refer to ACF/VTAM Version 3 Pro- 
gramming for failure analysis during a CLOSE macro instruc- 
tion. 


DSNLO151 VTAM SETLOGON FAILED 


RTNCD = error-code 
FDBK2 = open-flags 


Explanation: VTAM returned a non-zero return code after DB2 
invoked the SETLOGON macro instruction during termination of 
the distributed data function (DDF). VTAM return codes are 
defined in ACF/VTAM Version 3 Programming. 


| Internal DB2 Information ore 
This message is issued by the following CSECT(s): DSNLVINI 


End of Internal DB2 Information ee 


System Action: Termination of the DDF is initiated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine the cause of the 
failure, fix the error condition, and issue the -START DDF 
command. 


Problem Determination: Refer to ACF/VTAM Version 3 Pro- 
gramming for failure analysis. 


DSNLO161 DDF RECORD NOT FOUND IN BSDS 


Explanation: The distributed data facility (ODF) cannot find the 
DDF communication record in the bootstrap data set (BSDS). 
The DDF communication record contains the local location 
name, the LU name, and a password. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLVACB 


[| snd of Internal DB2 information 


System Action: Termination of the DDF is initiated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Use the Change Log Inventory 
to add the DDF communication record to the BSDS. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
15. 


DSNLO171 INVALID DDF RECORD FOUND IN BSDS 


Explanation: An invalid or incomplete distributed data facility 
(DDF) communication record was found in the bootstrap data 
set (BSDS). The DDF communication record contains the local 
location name, the LU name, and a password. 


fo = Interna! DB2 Information ~ 
This message is issued by the following CSECT(s): DSNLVACB 


Mee ee ae End of Interna! DB2 Information ee | 


System Action: Termination of the DDF is initiated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Use the Change Log Inventory 
to add a valid DDF communication record to the BSDS. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
15. 


DSNLO181 VSAM ERROR READING DDF RECORD IN BSDS 


RPLERRCD = error-code 


Explanation: A VSAM GET command was issued that resulted 
in a non-zero return code. RPLERRCD '‘error-code' is the 
VSAM return code. 


[ — Internal DB2 Information a ae | 
This message is issued by the following CSECT(s): DSNLVACB 


L End of Internal DB2 Information ee 


DSNLO016I — DSNLO20I 


System Action: Termination of the distributed data facility 
(DDF) is initiated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine the cause of the 
failure, fix the error condition, and issue the -START DDF 
command. 


The cause of the failure is dictated by the VSAM return code. 
The BSDS may have to be recovered by using a backup copy. 


Problem Determination: Refer to the appropriate VSAM publi- 
cations. 


DSNLO191 VTAM DOES NOT SUPPORT APPC FUNCTIONS 


Explanation: The installed release of VTAM does not support 
the advanced program-to-program communications (APPC) 
application program interface (API). The APPC API bit is not set 
in the VTAM function-list vector in the access-method-support 
vector list. 


a a Internal DB2 Information Ss 
This message is issued by the following CSECT(s): DSNLVACB 


a End of Interna! DB2 Information _ 


System Action: Termination of the distributed data facility 
(DDF) is initiated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine whether the 
installed release of VTAM supports the APPC API. If VTAM 
does not support the APPC API, a VTAM release that supports 
the APPC API must be installed before the DDF can be started. 


DSNLO20i KEYWORD 'THREAD' PARAMETER parameter 


FORMAT IN ERROR 


Explanation: The parameter value specified for the logical- 
unit-of-work ID on the CANCEL DDF THREAD has an invalid 
format. The correct form is 'netid.luname.luwunique', where: 


netid A 1- to 8-character network ID. 
luname A 1- to 8-character luname. 
luwunique A 12-character hex number. 


Luname and Juwunique are separated by a '.' delimiter. Netid 
is optional. If netid is specified, then netid and luname are sep- 
arated by a '.' delimiter. If netid is not specified, then the '.' 
delimiter before luname is not present. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLCNCL 


Cte eats as End of Internal DB2 Information gee 4 


System Action: The specified thread is not canceled. 


User Response: Determine the correct logical-unit-of-work ID 
of the distributed thread that is to be canceled and reissue the 
command. 


Problem Determination: Determine the correct value. The 
-DISPLAY THREAD command can be used to display all distrib- 
uted activity. 


DB2 Messages 3-99 











DSNLO021! — DSNLO26I 


DSNLO211 command IS ACCEPTED 


Explanation: The 'command' command has been accepted 
and asynchronous processing of 'command' has been initi- 
ated. The command can only be -START or -STOP the distrib- 
uted data facility. 


| internal DB2 Information : 
This message is issued by the following CSECT(s): DSNLSSRC 


as End of Internal DB2 Information See | 


System Action: The command was accepted and asynchronous 
processing has been initiated. 


DSNLO22! DDF THREAD logical-unit-of-work-id WAS PREVI- 


OUSLY CANCELED 


Explanation: The command to cancel the distributed data 
facility (DDF) thread 'logical-unit-of-work-id' was previously 
issued. The thread is currently being canceled. The CANCEL 
DDF THREAD command terminates an agent only if the agent is 
processing in DB2 or is currently suspended by DB2. For 
example, if the agent is not processing because the user has 
placed the agent on an MVS resource using the ENQUE 
command, the CANCEL DDF THREAD command has no effect 
on the agent until ENQUE completes and the agent returns to 
DB2. 


[ Internal DB2 Information ~ — | 
This message is issued by the following CSECT(s): DSNLCNCL 


a End of Internal DB2 Information ers 


System Action: None because the specified thread has already 
been canceled. 


DSNL023I = DDF IS ALREADY IN THE PROCESS OF STARTING 


Explanation: The distributed data facility (DDF) was starting 
when the -START DDF or -STOP DDF command was issued. 


| internal DB2 Information ~~ . “a 
This message is issued by the following CSECT(s): DSNLSSRC 


ee ee ee Ss End of Internal DB2 Information Of wate 


System Action: The issued command is not executed. 


DSNLO24I = DDF IS ALREADY IN THE PROCESS OF STOPPING 


Explanation: The distributed data facility (DDF) was stopping 
when the -STOP DDF or -START DDF command was issued. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLSSRC 


CP aah End of Internal DB2 Information heed 


System Action: The -START or -STOP DDF command is not 
executed. 
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DSNLO25i =A DISTRIBUTED AGENT FOR luw-id =token 
EXISTS AT THIS LOCATION BUT NOT AT SITE 


WITH LOCATION location AND LU luname 


Explanation: The DDF error monitor has detected that a dis- 
tributed agent exists at this location but not at the named 
partner location. 


Where 


luw-id = token 
The logical unit of work ID of the thread followed by 
an '=' sign and a token which may be used in place 
of luw-id in any DB2 command that accepts luw-id as 
input. 


location The location name of the partner site where a thread 


with the same 'luw-id' does not exist. 


luname The 8-character LUNAME of the partner location. 


| Internal DB2 Information : ‘| 


This message is issued by the following CSECT(s): DSNLEDDA, 
DSNLEDPE 


[ee oe End of Internal DB2 Information fatten Kall 


System Action: None. This message will repeat periodically 
until the inconsistency is resolved. 


Operator Response: Determine if the inconsistency is due to 
network conditions or a DB2 error. If a DB2 error is suspected, 
acquire documentation to diagnose the problem. (Console 
Dump, SYSLOG, and LOGREC from both locations.) 


If an indefinite inconsistency is suspected, use the CANCEL 
DDF THREAD command to terminate the thread. If CANCEL 
DDF THREAD fails to terminate the agent, use VTAM commands 
to terminate the thread conversations. 


Problem Determination: Use the DB2 DISPLAY THREAD 
command with DETAIL option at each DB2 subsystem to display 
information about the agent and its conversations. Use VTAM 
commands to display additional information about the conver- 
sations being used by the thread and also about network condi- 
tions. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


DSNLO261 LUW-ID luw-id =token APPEARS TO BE SUS- 
PENDED 
PARTNER LOCATION location 


PARTNER LU juname 


Explanation: The DDF error monitor has detected that a dis- 
tributed agent with the specified 'luw-id' at this location and at 
the named pariner 'location' may be suspended indefinitely. 


Where 


luw-id = token 
The logical unit of work ID of the thread followed by 
an '=' sign and a token which may be used in place 
of luw-id in any DB2 command that accepts luw-id as 
input. 


location The location name of the partner site where a thread 


with the same ‘luw-id' exists. 


luname ‘The 8-character LUNAME of the partner location. 





oo Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNLEDDA, 
DSNLEDPE 


[esse End of Internal DB2 Information te 


System Action: None. This message will repeat periodically 
until the inconsistency is resoived. 


Operator Response: Determine if the inconsistency is due to 
network conditions or a DB2 error. If a DB2 error is suspected, 
acquire documentation to diagnose the problem. (Console 
Dump, SYSLOG, and LOGREC from both locations.) 


If an indefinite inconsistency is suspected, use the CANCEL 
DDF THREAD command to terminate the thread. !f CANCEL 
DDF THREAD fails to terminate the agent, use VTAM commands 
to terminate the thread conversations. 


Problem Determination: Use the DB2 DISPLAY THREAD 
command with DETAIL option at each DB2 subsystem to display 
information about the agent and its conversations. Use VTAM 
commands to display additional information about the conver- 
sations being used by the thread and also about network condi- 
tions. 


Coilect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


DSNLO27I = dis-agent-type DISTRIBUTED AGENT WITH LUW-ID 
luw-id = token RECEIVED ABEND = abnd 


REASON = reason 


Explanation: A distributed agent has abended at this location. 
This message will be followed by zero or more occurrences of 
DSNLO28!, each of which describes a remote location where the 
distributed agent also exists and where diagnostic information 
might also need to be collected. This message is informational 
and with the DSNL028! message(s) identifies the remote 
locations where diagnostic information may have to be col- 
lected. 


Where 


'REQUESTING' if the thread that abended 
is an allied thread that has distributed 
activity and SERVER if the thread that 
abended is a database access thread. 


dis-agent-type 


luw-id = token The logical unit of work ID of the thread 
followed by an '=' sign and a 5 digit 
token value which may be used in any DB2 


command that accepts luw-id as input. 


abnd The abend code or zeros if the abend 
code is indeterminate. 
reason The DB2 reason code or zeros if the 


reason code is indeterminate. 


‘ee ‘— Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNLBABR 


tee et End of Internal DB2 information ees 


Problem Determination: Gather appropriate diagnostic infor- 
mation (refer to the System Programmer Response section of 


DSN027!1 — DSNL200! 


the abend reason code specified in this message if applicable). 
Refer to DSNLO28I message(s) for the names of the other 
location(s). 


DSNLO28i luw-id =token ACCESSING DATA FOR/AT 
LOCATION location 


LU luname 


Explanation: This message follows DSNLO27I and identifies a 
remote location where work may have been occurring for the 
distributed thread. This message is informational and with the 
DSNLO27! message identifies a remote Jocation where diag- 
nostic information may have to be collected. 


Where 


luw-id = token 
The logica! unit of work ID of the thread followed by 


an '=' sign and a token which may be used in place 
of luw-id in any DB2 command that accepts luw-id as 
input. 

location The LOCATION name of the remote site. 

luname The LUNAME ofthe remote location. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLBABR 


Ys ee ee, End of Internal DB2 Information fot | 


Problem Determination: See message DSNLO27I. 


DSNLO291 = DDF IS NOT INITIALIZED 


Explanation: A-START DDF or -STOP DDF command was 
issued before DDF was initialized during DB2 startup proc- 
essing. 


| S Interna! DB2 Information a ae | 
This message is issued by the following CSECT(s): DSNLSSRC 


eee End of Internal DB2 Information ree 


System Action: None 


Operator Response: Wait for the DSN9022! 'START DB2' 
NORMAL COMPLETION message and re-issue the command. 


DSNL200i DISPLAY LOCATION REPORT FOLLOWS— 


Explanation: This message is the title for the -DISPLAY 
LOCATION command report output. It precedes the other mes- 
sages generated by this command. This message is followed 
by messages DSNL201I and DSNL202!. The final message for 
the report is be message DSNL205Il. 


i Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLDLM 


ae ae End of Internal DB2 Information fetta en | 


System Action: The -DISPLAY LOCATION command continues 
normally. 
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DSNL201I — DSNL500I 


DSNL2011 LOCATION LINKNAME ALLIED DDF CONVER- 


SATIONS 


Explanation: The column headings for the list of locations gen- 
erated by the -DISPLAY LOCATION command are displayed. 
The definitions are listed below: 


Heading Description 

LOCATION The associated DB2 location name. 

LINKNAME The associated DB2 VTAM LU name. 

ALLIED The associated count of the allied threads. 

DDF The associated count of the database 
access threads. 

CONVERSATIONS _ The associated count of conversations. 


See message DSNL202I a for more specific description of these 
items. 


The message number and subsystem recognition character are 
not included in this message. 


Internal DB2 Information ~~~ “| 
This message is issued by the following CSECT(s): DSNLDLM 


ere End of Internal DB2 Information ee 


System Action: Processing continues normally. 


DSNL202I location linkname allied data-base-access 


conversations 


Explanation: This message lists the status of communications 
between a remote DB2 site and this DB2 subsystem. Informa- 
tion about the status appears below: 


ttem Description 

location An 8-byte name of the DB2 subsystem at the 
remote site. 

linkname The 8-byte DB2 LU name (name assigned by 
VTAM) at the remote site. 

allied A count of the allied threads at this location 


that access data at the remote DB2 subsystem. 


data-base-access 
A count of the database access threads at this 
location that access data for allied threads at 
the remote DB2 subsystem. 


A count of the total number of conversations 
between the two DB2 subsystems.The count 
include both allied and database threads. 


conversations 


The message number and subsystem recognition character are 
not included in this message. 


[pS Internal DB2 Information ss  H 
This message is issued by the following CSECT(s): DSNLDLM 


a End of Internal DB2 Information eee oes) 


System Action: Processing continues normally. 
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DSNL205! 


Explanation: This message follows messages DSNL200I, 
DSNL2011, and DSNL202! and indicates that the -DISPLAY 
LOCATION report has successfully completed. 


DISPLAY LOCATION REPORT COMPLETE 


The message number and subsystem recognition character are 
not included in this message. 


| internal DB2 Information = 
This message is issued by the following CSECT(s): DSNLDLM 


Pee End of Internal DB2 Information ee | 


System Action: Processing continues normally. 


DSNL2061 csect-name named-command COMMAND 


INVALID, DDF NOT STARTED 


Explanation: The 'named-command' command was issued 
before the distributed data facility (DDF) had been started. The 
'named-command' command executes successfully only if the 
DDF is operating. 


[- a Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNLDL, 
DSNLCNCL 


it ee End of Internal DB2 Information _ 


DSNLDL 
DSNLCNCL 


'-DISPLAY LOCATION' 
'-CANCEL DDF THREAD' 


System Action: Processing continues normally. 


DSNLS500I CONVERSATION FAILED TO LOCATION = locname 
RESOURCE = luname.modename. convid.sessid 
RTNCD = global viam primary return code 

FDBK2 = global viam secondary return code 
RCPRI = appc-specific primary return code 

RCSEC = appc-specific secondary return code 
SENSE = vtam sense code 


Explanation: An advanced program-to-program communi- 
cations (APPC) conversation failed, or could not be allocated, 
because a VTAM return code indicates a conversation failure. 
VTAM return codes are defined in VTAM Programming for LU 
6.2. VTAM sense codes that start with 00 represent DB2 reason 
codes. 


The variables that are not return codes are described as 
follows: 


Variable Description 

locname The location of the remote DB2 subsystem. 

luname The LU of the remote DB2 subsystem. 

modename The logon mode used by DB2 to allocate the 
conversation. 

convid The conversation identifier given DB2 by 
VTAM when the conversation was allocated. 

sessid The session identifier given DB2 by VTAM 


when the conversation was allocated. 





nas Internal DB2 Information aaa 
This message is issued by the following CSECT(s): DSNLVRPL 


[Sess ae Meo te End of internal DB2 Information ee 


System Action: Communication on the conversation is discon- 
tinued. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to VTAM Programming 
for LU 6.2 for failure analysis. 


Problem Determination: See System Programmer Response. 


DSNL501! CNOS PROCESSING FAILED WITH LOCATION 
locname FOR LU luname AND MODE modename 
RTNCD = global vtam return code 

FDBK2 = global vtam secondary return code 
RCPRI= appc-specific primary return code 
RCSEC = appc-specific secondary return code 


SENSE = vtam sense code 


Explanation: A failure occurred while attempting to negotiate 
limits with the specified location for a LU and mode. VTAM 
return codes are described in VTAM Programming for LU 6.2. 
VTAM sense codes that start with 00 represent DB2 reason 
codes. 


The variables are described as follows: 


Variable Description 

locname The location of the remote DB2 subsystem. 
luname The LU of the remote DB2 subsystem. 
modename The logon mode used by DB2 to allocate the 


conversation. 


| Internal DB2 Information 2 
This message is issued by the following CSECT(s): DSNLVCNS 


[End of Internal DB2 Information 


System Action: Al! communication to the remote location fails 
until the limits can be negotiated with the remote location. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to VTAM Programming 
for LU 6.2 for failure analysis. 


Problem Determination: See System Programmer Response. 


DSNL502i SYSTEM CONVERSATION FAILED TO LOCATION 
locname RESOURCE = iluname.modename. 
convid.sessid 

RTNCD = global vtam primary return code 
FDBK2 = global vtam secondary return code 
RCPRI= appe-specific primary return code 
RCSEC = appc-specific secondary return code 
SENSE = vtam sense code 


Explanation: A system conversation failed, or could not be 
allocated, because VTAM returned a non-zero return code. 
VTAM return codes are defined in VTAM Programming for LU 


DSNL501I — DSNL510I 


6.2. VTAM sense codes that start with 00 represent DB2 reason 
codes. 


The variables are described as follows: 


Variable Description 

locname The location of the remote DB2 subsystem. 

luname The LU of the remote DB2 subsystem. 

modename The logon mode used by DB2 to allocate the 
conversation. 

convid The conversation identifier given DB2 by 
VTAM when the conversation was allocated. 

sessid The session identifier given DB2 by VTAM 


when the conversation was allocated. 


ie Internal DB2 information i aaa 
This message is issued by the following CSECT(s): DSNLVRPL 


ae End of Internal DB2 Information oh Se 


System Action: Communication on the conversation is not 
allowed. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to VTAM Programming 
for LU 6.2 for failure analysis. 


Problem Determination: Refer to System Programmer 
Response. 


DSNL5031 LOCATION locname NOT CONNECTED, PASS- 


WORD FAILED 


Explanation: The requested VTAM function failed because the 
DB2 subsystem is not defined to access data at the specified 
location. The DB2-to-DB2 connection for the specified location 
cannot be established. 


| Internal DB2 Information 1 
This message is issued by the following CSECT(s): DSNLVRPL 


(heme te End of Internal DB2 Information in es ll 


System Action: All communication to the remote location fails 
until the local location and password are defined at the remote 
location. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Contact the security adminis- 
trator at the specified location to define the local DB2 sub- 
system to the specified location. 


DSNL5101 csect-name CONVLIMIT NEGOTIATED FROM x TO 
y WITH LOCATION locname FOR LU luname AND 


MODE modename 


Explanation: The maximum conversation limit is changed for a 
mode with a remote subsystem. The limit might change when a 
CNOS request is received from or sent to a remote subsystem, 
and the limit is determined by VTAM. 
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DSNL600I — DSNL701I 


x The most recent value of CONVLIMIT before 
the last CNOS request was processed by 
advanced program-to-program communi- 
cations (APPC)/VTAM for the specified mode 
name to the specified location. 


y The current value of CONVLIMIT for the 
specifed mode name to the specified location. 


locname The location of the remote DB2 subsystem that 
sent the CNOS request to the loca! DB2 sub- 
system, or received the CNOS request from 


the local DB2 subsystem. 


luname The LU defined for the specified tocation that 


had its CONVLIMIT changed. 


modename The logon mode for the specified location that 


had its CONVLIMIT changed. 


— Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNLVCNS, 
DSNLVPCS 


ee End of Internal DB2 Information ee 


System Action: Conversation requests are queued when the 
maximum conversation limit is reached for a mode to remote 
subsystem. 


DSNL600I RESOURCE UNAVAILABLE 
CORRELATION ID =correlation-id 
CONNECTION ID = connection-id 
LUW ID = juw-id = token 

REASON = reason-code 

TYPE = resource-type 

LOCATION = location-name 
NAME = resource-name 


Explanation: This message is produced at the requesting site 
when a distributed request requires a resource that is not 
available. 


The resource identified by 'resource-name' and 
'resource-type' was not available at 'location-name' due to 
the indicated reason code. 


correlation-id 
The correlation identifier of the thread associated 
with the requestor of the resource. 


connection-id 
The connection identifier of the requestor. 


luw-id = token 
The logical unit of work ID of the thread followed by 


an '=' sign and a token which may be used in place 
of luw-id in any DB2 command that accepts luw-id as 
input. 


Refer to message DSNT500! under “Service Controller and 
Installation Messages (DSNT...)” on page 3-121 for an explana- 
tion of the resource type and resource name. 


| rae = Internal DB2 Information a aie | 
This message is issued by the following CSECT(s): DSNLXQUR 


hie ten toee End of Internal DB2 Information ee ee 


System Action: The SQL statement cannot be executed. 
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Operator Response: See Problem Determination. 


Problem Determination: The reason the resource is unavail- 
able is identified by the reason code. The reason codes are 
described in “Section 4. DB2 Codes” on page 4-1. Collect the 
information described for the reason code received. 


Collect the following diagnostic items listed. in Appendix B, 
“Problem Determination” on page X-5: 1. 


DSNL700I csect-name CDB RESOURCE UNAVAILABLE, 
VTAM DEFAULTS MAY BE USED 

REASON = reason 

TYPE =type 


NAME = name 


Explanation: A requested function requires the communi- 
cations database (CDB), which is unavailable. VTAM defaults 
can be used to allocate conversations or to set conversation 
limits. 


r —— Internal DB2 Information ~~ 2 


This message is issued by the following CSECT(s): 


DSNLVCDB DSNLVCLM DSNLVPCS 
DSNLVVDB DSNLVVIX 


ese et ne! End of Internal DB2 Information bo eae 


System Action: If the SYSIBM.SYSMODESELECT table is una- 
vailable, VTAM defaults are used to allocate conversations. If 
the SYSIBM.SYSLUMODES table is unavailable, VTAM defaults 
can be used for conversation limits. If the 
SYSIBM.SYSLOCATIONS table is unavailable, conversations 
cannot be allocated to remote locations. 


Operator Response: Note the reason and type codes, and the 
name. 


Problem Determination: The reason for the resource’s unavail- 
ability is identified by a reason code. The reason codes that 
appear in this message are described in “Section 4. DB2 
Codes” on page 4-1. Refer to the Figure 4 in Appendix B, 
“Problem Determination” on page X-5 for an explanation of 
resource type codes. 


DSNL7011 = object-name DOES NOT EXIST IN THE CDB 


Explanation: The communication database (CDB) does not 
contain 'object-name'. The incorrect 'object-name' can be the 
database name, the table space name, or the table name. 


oe es Internal DB2 Information OY 
This message is issued by the following CSECT(s): DSNLVVDB 


eee End of Internal DB2 Information aes 


System Action: Termination of the distributed data facility 
(DDF) is initiated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine what caused the 
failure, define the object as required, and issue the -START 
DDF command. 


Problem Determination: Print the definition of the communi- 
cation database (CDB). 





DSNL702I CDB TABLE table-name DOES NOT HAVE 


PROPER COLUMN DEFINITIONS, COLUMN 
column-name IS MISSING OR INCORRECTLY 
DEFINED 


Explanation: The communication database (CDB) needs a defi- 
nition for 'column-name' in 'tablename'. The current defi- 
nition is missing or incorrect. 


internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLVVDB 


eee End of Internal DB2 Information pee eee ere) 


System Action: Termination of the distributed data facility 
(DDF) is initiated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine what caused the 
failure, define the column as required, and issue the -START 
DDF command. 


Problem Determination: Print the definition of the communi- 
cation database (CDB). 


DSNL703I table-name DOES NOT HAVE PROPER INDEX 


DEFINITIONS, INDEX index-name IS MISSING OR 
INCORRECTLY DEFINED 


Explanation: The communication database (CDB) requires an 
index name for 'table-name'‘. The current definition is missing 
or incorrect. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLVVIX 


eee ae End of Internal DB2 Information ae re 


System Action: Termination of the distributed data facility 
(DDF) is initiated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the failure, define 
the index as required, and issue the -START DDF command. 


Problem Determination: Print the definition of the communi- 
cation database (CDB). 


DSNL7021 — DSNL705I 


DSNL704I CDB OBJECT object-name DOES NOT HAVE 


PROPER REFERENTIAL CONSTRAINT DEFI- 
NITIONS 


Explanation: The communication database (CDB) requires ref- 
erential constraint definitions for 'object-name'. The current 
definition is missing or incorrect. 


—— > Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNLVVIX 


bss otf End of Internal DB2 information ee 


System Action: Termination of the distributed data facility 
(DDF) is initiated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine what caused the 
failure, define the missing referential constraint, and issue the 
-START DDF command. 


Problem Determination: Print the definition of the communi- 
cation database (CDB). 


DSNL7051 CDB IS UNAVAILABLE OR INCORRECTLY 


DEFINED 


Explanation: During start-up of the distributed data facility, the 
required CDB was unavailable or incorrectly defined. 


a Internal DB2 Information pS ey 
This message is issued by the following CSECT(s): DSNLVACB 


Pe eee End of Internal DB2 Information foes) 


System Action: Termination of the DDF is initiated. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to the previous 
message that specifies the cause of the CDB failure (DSNL700I, 
DSNL701, DSNL702!, DSNL703!, or DSNL7041). Determine what 
caused the failure, fix the error condition, and issue the -START 
DDF command. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1. 
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DSNMO001I — DSNMO004I 





IMS/VS Attachment Facility Messages (DSNM...) 


Ail of the DSNM... messages will be sent to the 
IMS master terminal operator (MTO), and to the 
appropriate MVS console. 


DSNMO01! IMS/VS xxxx CONNECTED TO SUBSYSTEM yyyy 


Explanation: This is an information message only. The control 
region of the IMS/VS system specified in the message (as 
'xxxx') has successfully connected to the DB2 subsystem spec- 
ified in the message as 'yyyy'. The message is sent to the 
IMS/VS master terminal operator. 


— Internal DB2 Information ~~~ Se || 
This message is issued by the following CSECT(s): DSNM!DOO 


a ee End of Internal DB2 Information get he 2 


System Action: IMS/VS transactions can access DB2 
resources. 


DSNMO0021_ ~=—sIMS/VS xxxx DISCONNECTED FROM SUBSYSTEM 


yyyy RC=rc 


Explanation: The IMS/VS system (named 'xxxx') control 
region has disconnected from the DB2 subsystem (named 
‘yyyy') for the RC (reason code) of 'rc'. The message is sent 
to the IMS/VS master terminal operator. The reason code 
values are: 


Value Description 

A IMS/VS is terminating normally (for example, /CKPT 
FREEZE command). 

B IMS/VS is terminating abnormally. 


DB2 is terminating in a quiesce fashion (for 
exampie, DB2 stop quiesce command). 


D DB2 is terminating abnormally. 


E The connection between IMS/VS and the DB2 sub- 
system is terminating; however, both subsystems 
remain operational. 


| Internal DB2 Information = ae a 
This message is issued by the following CSECT(s): DSNMINIT 


a ee End of Internal DB2 Information ee | 


System Action: The connection between IMS/VS and DB2 ter- 
minated. IMS/VS transactions can no longer access DB2 
resources. 


Operator Response: Notify the system programmer. 


System Programmer Response: Reason code A, C, or E makes 
this an information message. Reason code D indicates that a 
serious problem occurred in the DB2 subsystem, and that the 
SYS1.LOGREC should be examined. For reason code B or D, 
determine the failing subcomponent, and refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


Problem Determination: SYS1.LOGREC and/or dump informa- 
tion may be available for reason codes B and D. 


DSNMO03I =IMS/VS xxxx FAILED TO CONNECT TO SUB- 


SYSTEM yyyy RC=rc 


Explanation: The IMS/VS system (named 'xxxx') control 
region did not connect to the DB2 subsystem (named 'yyyy'). 
This message is sent to the IMS/VS master terminal operator. 
The return code 'rc' indicates the reason for the failure. 


Value Description 


00 The DB2 subsystem is not operational. However, a 
notify message has been queued and, when the DB2 
subsystem is started, it will automatically connect to 
IMS/VS. 


04 The connection attempt failed between IMS/VS and 
the DB2 subsystem. 


ies Internal DB2 Information ia ie 
This message is issued by the following CSECT(s): DSNMIDOO 


eee End of Internal DB2 Information see Aacctns stl 


System Action: iMS/VS transactions cannot access DB2 
resources. 


Operator Response: For return code 00, start the DB2 sub- 
system. For return code 04, notify the system programmer. 


System Programmer Response: For return code 04, refer to 
Section 2 (Volume 1) of Administration Guide for failure anal- 
ysis procedures. 


Problem Determination: For return code 04, an IMS/VS attach- 
ment facility snap record (code X'5501FF') is written to the 
IMS/VS log to indicate the reason for the failure. 


DSNMO004E RESOLVE INDOUBT ENTRY(S) ARE OUT- 


STANDING FOR SUBSYSTEM xxxx 


Explanation: The DB2 subsystem ID of 'xxxx' has 'indoubt' 
entry(s) remaining after the IMS/VS subsystem has attempted to 
resolve the work units that are indoubt. This message is sent to 
the IMS/VS master terminal operator. 


| 2 Internal DB2 Information : : : a 
This message is issued by the following CSECT(s): DSNMRIO0 


a End of Internal DB2 Information eee 


System Action: The connection between the DB2 and IMS/VS 
subsystems remains active, and applications can access DB2 
resources. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 6 (Volume 2) 
of Administration Guide for failure analysis procedures. DB2 
commands (DISPLAY THREAD and RECOVER INDOUBT) may 
be used to display and resolve the work unit(s) that are indoubt. 
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DSNMO05!I — DSNM104I 


Problem Determination: Recovery information is available on 
the DB2 log and IMS/VS log to assist in the resolution of the 
work unit(s) indoubt. For each indoubt work unit, an IMS/VS 
attachment facility snap record (code X'5501FE') is written to 
the IMS/VS log. 


DSNMO005I RESOLVE INDOUBT SYNCHRONIZATION 


PROBLEM WITH SUBSYSTEM xxxx 


Explanation: The DB2 subsystem ID of 'xxxx' has 'indoubt' 
entry(s) remaining that have been committed by the DB2 sub- 
system and should have been committed by IMS/VS, but they 
were aborted. The message is sent to the IMS/VS master ter- 
minal operator. 


, | Internal DB2 Information — | 
This message is issued by the following CSECT(s): DSNMRIOO 


Usa ee ase End of Internal DB2 information eee | 


System Action: The connection between the DB2 and IMS/VS 
subsystems remains active, and applications can access DB2 
resources. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 6 (Volume 2) 
of Administration Guide for resolve-indoubt failure analysis. 
DB2 commands may not be used to display the entries in ques- 
tion. 


Problem Determination: Recovery information is available on 
the DB2 log and IMS/VS log to assist in the resolution of the 
problem. For each indoubt work unit, an IMS/VS attachment 
facility snap record (code X'5501FE') is written to the IMS/VS 
log. 


DSNM1001 SUBSYSTEM xxxx NOT AVAILABLE 


Explanation: The IMS/VS attachment facility command facility 
which routes commands to the DB2 subsystem cannot perform 
its functions because the DB2 subsystem named 'xxxx' is con- 
sidered not operational. 
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ae Se Internal DB2 Information ee 
This message is issued by CSECT(s): DSNMCMDO 


DF ee End of Internal DB2 Information ae 


System Action: The connection to the DB2 subsystem failed for 
the command. The command is rejected. 


System Programmer Response: If the DB2 subsystem is opera- 
tional, refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures. The person entering the request 
may not be authorized to execute the command. If the DB2 sub- 
system is not operational, DB2 commands from IMS/VS cannot 
be processed. 


Problem Determination: A snap record (x'5501FF') is written 
to the IMS/VS log if a connection request failed. 


DSNM1041 = xxxx COMMAND FAILED 


Explanation: The DB2 command specified by 'xxxx' failed to 
complete. 


System Action: The command terminated without providing an 
output message. Commands will still be allowed by the IMS/VS 
attachment facility. 


= Internal DB2 Information Es Ee 
This message is issued by CSECT(s): DSNMCMDO 


[ieetaccati nana End of Interna! DB2 Information eee 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: If the command failed because of an 
abend, a snap record (X'5501FF') is written to the IMS/VS log 
and SYS1.LOGREC information is available. 





DSNP001! — DSNPO0O2I 





Data Space Manager Messages (DSNP...) 


The DSNP-prefixed messages contain a connection 
ID, a correlation ID, and a logical-unit-of-work ID. 
Messages that have the same connection ID, cor- 
relation ID, and logical-unit-of-work ID relate to the 
same user. This makes it possible to scan a 
number of DSNP-prefixed messages and group 
activities involving a given user. 


DSNPOO1I DSNPmmmm — data-set-name IS WITHIN nk 
BYTES OF AVAILABLE SPACE. RC=orererrr 
CONNECTION-ID = xxxxxXxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: This message warns of an impending space 
shortage. The data space manager (DSM) extend function 
CSECT 'DSNPmmmm' has detected the space shortage 
through the use of a 'hedge' quantity 'n'. Reason code 
'rrerrrrr' gives some information about why space could not be 
obtained. (See “Section 4. DB2 Codes” on page 4-1.) 


There may also be some preceding DSM and VSAM messages 

that can help to determine why space cannot be obtained. The 

connection, correlation, and ltogical-unit-of-work IDs identify the 
user or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


‘ae Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNPXTNO 


ae End of Internal DB2 Information ogee | 


System Action: If sufficient space is available for the current 
request, continue. Otherwise, message DSNPO07I will follow, 
and the current SQL request will fail. 


Operator Response: DSM messages are directed to the data- 
base administrator (DBA) or system administrator. However, 
the DBA or system administrator may request that the operator 
issue an MVS WRITELOG operator command (for example, 'W 
A') to obtain MVS SYSLOG output. The SYSLOG sometimes 
contains media manager messages that may be helpful to the 
DBA or system administrator in determining why space could 
not be allocated. 


System Programmer Response: Based on the reason code 
(RC) in the message, as well as information that might be avail- 
able in access method services or VSAM messages preceding 
this one, try one of the following: 


© If you do not anticipate further extension of this table space 
or index, ignore the message. 


e Ifthe table space or index is backed by storage group- 
defined data sets and this data set is not at maximum (123) 
extents, use the ALTER STOGROUP DDL statement to add 
volumes to the storage group (up to 133 of them). 

* {f the table space or index is backed by 'user-defined' data 
sets, and not at maximum (123) extents for the data set, 
issue an ALTER ADDVOLUMES access method services 
command to provide additional volumes (up to 133 of them). 
Or, if the table space is nonpartitioned and the high allo- 
cated RBA is greater than or equal to 2 gigabytes 
(2,147,483,648) for the indicated data set, define the data set 
required for the next sequential piece. (Actually, in this 
case, there should be an indication in console messages or 
the reason code that the data set required for the next piece 
was not found.) 

¢ ff the data set is at maximum (123) extents, try reorganizing 
the table space or index into a data set or data sets having 
larger primary and secondary values. This process is dis- 
cussed in Section 3 (Volume 1) of Administration Guide. 


Problem Determination: Examine the console messages, 
SYS1.LOGREC information, and SYSLOG to determine the 
reason for the condition. Try to resolve it by the methods 
described in the Operator Response section of this message. If 
for some reason you feel that this message indicates a problem 
in an IBM program, you should provide the following sources of 
information about the problem: 


¢ Console sheet showing the message and related messages 
that may precede or follow it. 

¢ System fog printout (obtained via MVS WRITELOG operator 
command) showing related VSAM/media manager mes- 
sages that may appear there (usually needed only if you 
have a message or reason code that indicates a media 
manager services problem occurred). 

¢ Integrated catalog facility (ICF) catalog listing showing 
characteristics of the data set in question and of the ICF 
catalog itself. 

* VTOC listing of pack(s) associated with the request, 
showing space available for data sets, catalogs, VTOC 
index, and the VTOC itself, as well as data set extent infor- 
mation. 

e Any associated dumps. 

¢ SYS1.LOGREC listing showing entries at or near the time of 
the problem (unless these appear in an associated dump). 

¢ Depending on the reason code, the results of certain SQL 
SELECT operations on DB2 catalog tables may be needed. 
(See “Section 4. DB2 Codes” on page 4-1.) 


DSNPO02I DSNPmmmm — DEFINE FAILED FOR data-set- 
name. RC =errrrrrre CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyy, 


LUW-ID = logical-unit-of-work-id = token 


Explanation: Data set definition has failed (in CSECT 
'DSNPmmmm') for the reason identified by RC. (See “Section 
4. DB2 Codes” on page 4-1.) The connection ID, correlation ID, 
and logical-unit-of-work ID (LUW-ID) identify the user or appli- 
cation that encountered the problem. The connection, corre- 
lation, and logical-unit-of-work IDs identify the user or 
application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in piace of logicai- 
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unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNPDFN1 


be x ee End of Internal DB2 Information | 


System Action: The data space manager (DSM) terminates its 
actions associated with the current SQL request. Higher level 
functions may terminate the current SQL request or the unit of 
recovery that issued the request. 


Operator Response: This message is directed to either the 
database administrator or the system administrator. Bring the 
message to their attention if it appears on the MVS operator’s 
console. The installation should consider directing DB2 mes- 
sages to a console other than the operator’s console. 


System Programmer Response: Investigate the problem indi- 
cated by the reason code and preceding access method ser- 
vices messages, if any, and correct it if possible. If an 
out-of-space condition exists, see the description of message 
DSNP0O01I for actions to consider. 


Problem Determination: See Problem Determination of 
message DSNP001I for this information. 


DSNPO0O3I DSNPmmmm — RESET FAILED FOR data-set- 
name. RC=errrrrre CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: Reset, a data space manager (DSM) function 
invoked by DB2 utilities, has failed in CSECT 'DSNPmmmm' for 
the reason identified by RC. (See “Section 4. DB2 Codes” on 
page 4-1.) The connection ID, correlation ID, and logical-unit- 
of-work ID (LUW-ID) identify the user or application that 
encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. !f the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and tie together activities 
involving a given user. 


Internal DB2 Information 


This message is issued by the following CSECT(s): DSNPRSTO, 
DSNPRST1 


eS End of Internal DB2 Information a 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher level functions may terminate the 
current SQL request or the unit of recovery that issued the 
request. 
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Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that per- 
son’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Investigate the problem indi- 
cated by the reason code and preceding DB2, access method 
services, or VSAM messages, if any, and correct it if possible. 


It may be necessary for you to delete and redefine the data set 
using access method services. Consider making a backup copy 
before doing this. (Use DB2 utilities to make the copy; in 
general, VSAM utilities do not work on DB2 database services 
data sets.) 


Problem Determination: See Problem Determination for 
message DSNP001I for this information. 


DSNPO04! DSNPmmmm — DELETE FAILED FOR data-set- 
name. RC=rrrerrrr CONNECTION-ID = xxxxXxXxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: Deletion has failed in CSECT 'DSNPmmmm' for 
the reason identified by RC. (See “Section 4. DB2 Codes” on 
page 4-1.) The connection ID, correlation ID, and logical-unit- 
of-work ID (LUW-ID) identify the user or application that 
encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. !f the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNPDLT1, 
DSNPDLLR, DSNPCILR 


Gs ee End of Internal DB2 Information eee | 


System Action: The data space manager (DSM) terminates its 
actions associated with the current SQL request. Higher level 
functions may terminate the current SQL request or the unit of 
recovery that issued the request. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that per- 
son’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Investigate the problem indi- 
cated by the reason code and preceding access method ser- 
vices messages if any, and correct it if possible. Check the 
data set and delete it by using access method services directly 
if reasonable to do so. Consider making a backup copy before 
doing this. (Use DB2 utilities to make the copy; in general, 
VSAM utilities do not work on DB2 data sets.) 


Problem Determination: See Problem Determination for 
message DSNP001I for this information. 


OSNP005! DSNPmmmm — COULD NOT REMOVE EXCESS 
VOLUMES FROM CANDIDATE LIST OF data-set- 
name CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy; 


LUW-ID = logical-unit-of-work-id =token 


Explanation: Volumes from a storage group were entered in 
the data set’s candidate list and could not be removed by 
CSECT 'DSNPmmmm' after some data space manager (DSM) 
operation. The connection !D, correlation ID, and logical-unit- 
of-work ID (LUW-ID) identify the user or application that 
encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id ‘as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


This is not a major problem. However, the data set will not 
properly reflect subsequent deletions from the volume list in its 
storage group (via ALTER STOGROUP command in SQL), 
because the data set’s integrated catalog facility (ICF) catalog 
entry still contains the volume serial numbers. 


If needed, the storage group in question can be identified by 
issuing an SQL SELECT to get information about the table 
space or index that is identified by the third and fourth qual- 
ifiers (database name, table space name) in the data set name. 


-. oS internal DB2 Information i ae iad | 
This message is issued by the following CSECT(s): DSNPRMVV 


ae End of Internal DB2 Information eee ts 


System Action: Operation continues. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Look for associated DSM and 
access method services messages preceding this one to get 
additional information. Attempt an ALTER REMOVEVOLUMES 
access method services command, if appropriate, after issuing 
a LISTCAT to see which volumes are recorded as ‘candidate’ 
in the integrated catalog facility (ICF) catalog. 


Problem Determination: See Problem Determination for 
message DSNPO01I for this information. (However, there should 
not be a need for VTOC or SYSLOG information for this case.) 


DSNP0071! DSNPmmmm — EXTEND FAILED FOR data-set- 
name. RC =rerererre CONNECTION-ID = xxxxxXxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id = token 


Explanation: Extension has failed in CSECT 'DSNPmmmm' of 
the data space manager (DSM) for the reason identified by RC. 
(See “Section 4. DB2 Codes” on page 4-1.) Additional informa- 
tion may be available in other console messages from this and 
other subcomponents or products. The connection ID, corre- 
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lation ID, and logical-unit-of-work ID (LUW-ID) identify the user 
or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information ae | 
This message is issued by the following CSECT(s): DSNPXTNO 


ae End of Internal DB2 Information oe Pees St 


System Action: The DSM terminates its actions associated with 
the current SQL request or utility operation. Higher level func- 
tions may terminate the current SQL request or the unit of 
recovery that issued the request. 


Operator Response: See Operator Response for message 
DSNPO011 for this information. 


System Programmer Response: See System Programmer 
Response for message DSNP0O01I for this information. 


Problem Determination: See Problem Determination for 
message DSNPO01! for this information. 


DSNP008l DSNPmmmm — REQUIRED USER — DEFINED 
DATA SET NOT AVAILABLE— data-set-name 
RC =ererrrrr CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logica!-unit-of-work-id =token 


Explanation: An attempt to create or extend a table space or 
index using user-defined data sets has failed in CSECT 
'DSNPmmmm' of the data space manager (DSM). One or more 
of the data sets could not be accessed for the reason indicated 
by RC. (See “Section 4. DB2 Codes” on page 4-1.) The con- 
nection ID, correlation ID, and logical-unit-of-work ID (LUW-ID) 
identify the user or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation !D, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


internal DB2 Information oe | 


This message is issued by the following CSECT(s): DSNPCPSO, 
DSNPXTNO 


eae End of Internal DB2 Information _ 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher level subcomponents may termi- 
nate the current SQL request or the unit of recovery that issued 
the request. 
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Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: If the data set does not exist, 
create it before attempting the create table space/index or 
extend data set again. | 


Problem Determination: See Problem Determination for 
message DSNP0O01I for this information. 


DSNPOOSI THE FOLLOWING ERROR MESSAGES WERE 
RECEIVED FOR operation ON data-set-name 
DSNP0101 END OF ERROR MESSAGES. 


CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 
LUW-ID = logical-unit-of-work-id =token 


Explanation: Messages DSNPO0O09i and DSNP010I enclose a 
block of messages that are received by the data space 
manager (DSM) subcomponent of DB2 in response to an access 
method services (AMS) operation. 


operation The access method services operation 
that was being performed. 
The data set on which the operation was 


being performed. 


data-set-name 


The prefix of the messages in the block is usually IDC (access 
method services messages). However, the prefix can also be 
IKJ (dynamic allocation) or other system subcomponent IDs. 
Refer to the appropriate MVS publication for descriptions of the 
enclosed messages. 


The operation may be DEFINE CLUSTER, ALTER 
ADDVOLUMES, ALTER REMOVEVOLUMES, or DELETE 
CLUSTER. One or more other DSM messages appear after this 
message to explain what happened as a result of the failure of 
this access method services request. The connection ID, corre- 
lation ID, and logical-unit-of-work ID (LUW-ID) identify the user 
or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of lfogical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


= se Internal DB2 Information “<< = 
This message is issued by the following CSECT(s): DSNPAMS2 


(ep ee eg End of Interna! DB2 Information ee eee 


System Action: Operation continues. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that | 
person’s attention if it appears on the MVS operator’s console. 

The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Use this information to help 
resolve problems indicated by other DSM messages that will 
appear shortly after. 
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Problem Determination: See Problem Determination for 
message DSNP001! for this information. 


DSNP0O111 DSNPmmmm —. MEDIA MANAGER SERVICES 
ERROR FOR data-set-name. MMRC =cccccccc 
DSMRC = ffffffff CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id = token 


Explanation: The MMRC is the return code that DB2 received 
from media manager services. Refer to the appropriate MVS 
publication for a description of these codes. DSMRC is a DSM 
reason code that indicates which of the media manager ser- 
vices functions, update or extend, failed. (See “Section 4. DB2 
Codes” on page 4-1.) The message is from CSECT 
‘DSNPmmmm' of the data space manager (DSM). The con- 
nection ID, correlation 'D, and logical-unit-of-work ID (LUW-ID) 
identify the user or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


a — Internal DB2 Information ~~ ] 


This message is issued by the following CSECT(s): DSNPIPP, 
DSNPXTNO, DSNPRSPO, DSNPRSTO 


[End of Internat DB2 Information 


System Action: The DSM terminates its actions associated with 
the current SQL request. Higher level functions may terminate 
the current SQL request or the unit of recovery that issued the 
request. 


Operator Response: DSM messages are directed to either the 
database administrator (DBA) or the system administrator. 
However, they may request that the operator issue an MVS 
WRITELOG operator command (for example, 'W A') to obtain 
MVS SYSLOG output. The SYSLOG sometimes contains media 
manager messages that may be helpful to the DBA or system 
administrator in determining why space could not be allocated. 


System Programmer Response: This message may be pre- 
ceded by one or more IEC or ICY messages on the console or 
in SYSLOG. These messages help to determine what happened 
and what action to take. 


Problem Determination: See Problem Determination for 
message DSNP0O01I for this information. 


DSNP012I DSNPmmmm — ERROR IN ICF CATALOG LOCATE 
FUNCTION FOR data-set-name CTLGRC = cc 
CTLGRSN = zzzzrrrr CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: CTLGRC and CTLGRSN are the return and reason 
codes that DB2 received from the SVC 26 (ICF catalog locate 
function). The reason code is in the same format as that 
returned to the data space manager (DSM) by the SVC 26. In it, 
'zzzz' is the hexadecimal value of the last two characters of 
the SVC 26 CSECT that set the code. The full CSECT name is 
derived by appending these two characters to 'IGGOCL'. The 








‘rrrr' part is the numeric part of the reason code, in 
hexadecimal. 


See the description of access method services message 
iDC30091 in the appropriate MVS publication for explanations of 
the return code and the numeric portion ('rrrr') of the reason 
code. The values documented there are decimal, whereas the 
value in this message is hexadecimal. 


The message is from CSECT 'DSNPmmmm' of the data space 
manager (DSM). The connection ID, correlation ID, and logical- 
unit-of-work ID (LUW-ID) identify the user or application that 
encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. !f the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNPAVLR DSNPCLOO DSNPDFN1 
DSNPGNPO DSNPIPP DSNPSCTD 
DSNPSCTO 


LS End of interna! DB2 Information _____——_— 


System Action: The DSM terminates its actions associated with 
the current SQL request. Higher level functions may terminate 
the current SQL request or the unit of recovery that issued the 
request. 


This message is directed to the database administrator or the 
system administrator. Bring it to that person’s attention if it 
appears on the MVS operator’s console. The installation 
should consider directing DB2 messages to a console other 
than the operator’s console. 


System Programmer Response: Correct the problem indicated 
by the catalog return and reason codes. 


Problem Determination: See Problem Determination for 
message DSNP001! for this information. 


DSNPO131 INSUFFICIENT PRIMARY ALLOCATION SPACE TO 
FORMAT CONTROL PAGES IN DATA SET data-set- 
name CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: Data space manager (DSM) has discovered that 
the primary space quantity given in the data set definition was 
not large enough. Formatting of required control information in 
the first several pages was not possible. The connection ID, 
correlation ID, and logical-unit-of-work !D (LUW-ID) identify the 
user or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
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unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-!D relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNPIPP 


—— End of internal DB2 Information ee 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher level functions may terminate the 
current SQL request or the unit of recovery that issued the 
request. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: This should occur only for 
table spaces or indexes that are not storage group defined. 
(The DB2 interpreter forces the initial allocation to be large 
enough if a storage group is used.) Check both the page size 
specification (4K or 32K bytes) and the number of control pages 
required (2 for table space, 3 for index space). Specify primary 
allocation value again so that at least (pages * page size) bytes 
are allocated. 


Problem Determination: See Problem Determination for 
message DSNPO01I for this information. 


DSNPO14t IRLM MANUAL LOCK REQUEST FAILED. 
RC =rr,SC =ssssssss, 

CONNECTION-ID = xxxxxXxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id = token 


Explanation: The data space manager (DSM) subcomponent of 
DB2 réquested a manual lock on a data set, but the lock could 
not be obtained for reasons specified in RC and SC. RC and SC 
are the return code and reason code from IRLM. RC and the 
first two digits of SC are documented in “Section 5. IRLM Mes- 
sages and Codes” on page 5-1. The connection ID, correlation 
ID, and logical-unit-of-work ID (LUW-ID) identify the user or 
application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. A subsequent message, DSNPO01I or 
DSNPO07I, indicates the name of the data set for which the tock 
was requested. 


If message DSNT376I was received before message DSNPO14l, 
the lock request failed because of a timeout condition. Other- 
wise, refer to the IRLM return and reason codes for an explana- 
tion of the failure. 
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| Internal DB2 Information ~~ ————— 
This message is issued by the following CSECT(s): DSNPXTNO 


Ree ge eee End of Internal DB2 Information eee i 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher level functions may terminate the 
current SQL request or the unit of recovery that issued the 
request. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Investigate the indicated IRLM 
problem. 


Problem Determination: Provide the console sheet and a 
dump. A GTF trace may also be required. Refer to Section 5 of 
Diagnosis Guide and Reference for IRLM service aids providing 
additional information. Refer to the explanation section of this 
message for additional problem determination information. 


DSNPmmmm — IRLM MANUAL UNLOCK 
REQUEST FAILED. RC =rr,SC =ssssssss, 
CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 
LUW-ID = logical-unit-of-work-id = token 


DSNPO15I 


Explanation: The data space manager (DSM) subcomponent of 
DB2 requested a manual! unlock on a data set, but the unlock 
could not be performed for reasons specified in RC and SC. RC 
and SC are the return code and reason code from IRLM. RC 
and the first two digits of SC are documented in “Section 5. 
IRLM Messages and Codes” on page 5-1. The connection ID, 
correlation ID, and logical-unit-of-work ID (LUW-ID) identify the 
user or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNPXTNO 


[isthe ate oD End of internal DB2 Information Cees 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher level functions may terminate the 
current SQL request or the unit of recovery that issued the 
request. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
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person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Investigate the IRLM problem 
indicated. 


Problem Determination: Provide console sheet and dump. A 
GTF trace may also be required. Refer to Section 5 of Diag- 
nosis Guide and Reference for IRLM service aids providing 
additional information. See explanation section of this 
message for additional problem determination information. 


DSNPO16! CREATE FAILED FOR pageset-name. RC=errrrrrr 
CONNECTION-ID = xxxxxXxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: Creation of a table space or index space has 
failed in the data space manager (DSM) for the reason given in 
RC. (See “Section 4. DB2 Codes” on page 4-1.) The pageset- 
name format is 'dbname.tiname', where 'dbname' is the data- 
base name, and 'tiname' is the table space or index space 
name. 


This message is intended to identify the function that was in 
progress at the time of a failure. The specific failure is usually 
identified by a preceding message. The connection ID, corre- 
lation ID, and logical-unit-of-work ID (LUW-ID) identify the user 
or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNPCPSO 


Dae ee End of Internal DB2 Information thus = S| 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher level functions may terminate the 
current SQL request or the unit of recovery that issued the 
request. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Investigate the problem indi- 
cated by reason code and preceding messages, and correct it if 
possible. 


Problem Determination: See Problem Determination for 
message DSNPOO1I for this information. 


DSNP017I RESET FAILED FOR pageset-name. RC=rrrrrrrr 
CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: Reset has failed in CSECT DSNPRSPO of the data 
space manager (DSM) subcomponent of DB2 for a table space 
or index space for the reason given in RC. (See “Section 4. 
DB2 Codes” on page 4-1.) The 'pageset-name' format is 
‘dbname.tiname', where 'dbname' is the database name and 
'tiname' is the table space or index space name. 


This message is intended to identify the function that was in 
progress at the time of a failure. The specific failure is usually 
identified by a preceding message. The connection (D, corre- 
lation 1D, and Jogical-unit-of-work ID (LUW-ID) identify the user 
or application that encountered the problem. 


ALUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation iD, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNPRSPO 


| Ss End of Internal DB2 Information | 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher level functions may terminate the 
current SQL request or the unit of recovery that issued the 
request. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: Investigate the problem indi- 
cated by the reason code and preceding messages, and correct 
if possible. 


Problem Determination: See Problem Determination for 
message DSNP001I for this information. 


DSNP018I DROP FAILED FOR pageset-name. RC=orrrrrrr 
CONNECTION-ID = xxxxxxxx, 
CORRELATION-ID = yyyyyyyyyyyy, 


LUW-ID = logical-unit-of-work-id =token 


Explanation: Drop has failed in CSECT DSNPDPSO of the data 
space manager (DSM) subcomponent of DB2 for a table space 
or index space for the reason given in RC. (See “Section 4. DB2 
Codes” on page 4-1.) The 'pageset-name' format is 
‘dbname.tiname', where 'dbname' is the database name and 
'tiname' is the table space or index space name. This 
message is intended to identify the function that was in 
progress at the time of a failure. The specific failure is usually 
identified by a preceding message. The connection ID, corre- 
lation ID, and logical-unit-of-work ID (LUW-ID) identify the user 
or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
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of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection !D, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNPDPSO 


ce End of Internal DB2 Information ees 


System Action: DSM terminates its actions associated with the 
current SQL request. Higher tevel functions may terminate the 
current SQL request or the unit of recovery that issued the 
request. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
person’s attention if it appears on the MVS operator’s console. 
The installation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: investigate the problem indi- 
cated by the reason code and preceding messages, and correct 
it if possible. 


Problem Determination: See Problem Determination for 
message DSNPO01I for this information. 


DSNP0191 DSNPmmmm — REALLOCATE FAILED FOR data- 
set-name. RC=crrreerrr 

CONNECTION-ID = xxxxxxxx, 

CORRELATION-ID = yyyyyyyyyyyy; 


LUW-ID = logicai-unit-of-work-id =token 


Explanation: After a successful ALTER REMOVEVOLUMES 
request, the data space manager (DSM) subcomponent of DB2 
was unable to reallocate the data set for the reason indicated 
by RC. (See “Section 4. DB2 Codes” on page 4-1.) The 
message is issued by CSECT 'DSNPmmmm' of the DSM. The 
connection !D, correlation ID, and logical-unit-of-work ID 
(LUW-ID) identify the user or application that encountered the 
problem. 


A LUW-ID of ‘*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNPRMVV 


Ue eae End of Internal DB2 Information _ 


System Action: Operation continues. 


Operator Response: This message is directed to the database 
administrator or the system administrator. Bring it to that 
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person’s attention if it appears on the MVS operator’s console. 
The instailation should consider directing DB2 messages to a 
console other than the operator’s console. 


System Programmer Response: The data set and corre- 
sponding page set piece or partition can usually continue to be 
used by the DB2 subsystem. However, they should be stopped 
and restarted at the earliest possible time in order to synchro- 
nize the allocation control blocks with the integrated catalog 
facility (ICF) catalog volume list. 


Problem Determination: See Problem Determination for 
message DSNP001I for this information. 


DSNPO0201 _—scsect-name - USER DEFINED ATTRIBUTES INCOR- 
RECT FOR data-set-name. RC=rerrrrr 
CONNECTION-ID = xxxxxxxx, 

CORRELATION-ID = yyyyyyyy, 


LUW-ID = logical-unit-of-work-id = token 


Explanation: The specified data set was access method ser- 
vices user defined and does not have the required DB2 attri- 
butes. The connection ID, correlation ID, and 
logical-unit-of-work ID (LUW-ID) identify the user or application 
that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


<< ~~ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNPSTCO 


eee tee dee End of Internal DB2 Information ee 


System Action: No action is taken with the named data set. An 
error code is returned and a dump is not taken. 


Operator Response: Notify the system programmer. 


System Programmer Response: Delete the named data set 
and DEFINE it with the correct attributes. 


Problem Determination: Obtain an access method services 
LISTCAT for the named data set’s attributes. Refer to Section 3 
(Volume 1) of Administration Guide for the correct data set defi- 
nition attributes. 
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csect-name HSM RECALL FAILED FOR DSNAME 
= dsn HSMRC = errrrrrr, HSMRSN = ssssssss 
CONNECTION ID = xxxxxxxx, CORRELATION 

ID = yyyyyyyyyyyy, LUW-ID = logical-unit-of-work-id 
=token 


DSNP028! 


Explanation: This message indicates that a required data set 
has been migrated by HSM and an attempt to recall the data set 
has failed, preventing DB2 from accessing the data set. The 
HSMRC and HSMRSN fields can be used to determine HSM 
failure. See Problem Determination below. The connection ID, 
correlation ID, and logical-unit-of-work ID (LUW-ID) identify the 
user or application that encountered the problem. 


A LUW-ID of '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


Messages having the same connection ID, correlation ID, and 
LUW-ID relate to the same user. This makes it possible to scan 
a number of DSNP-prefixed messages and group activities 
involving a given user. 


[ Internal DB2 Information ae ea 
This message is issued by the following CSECT(s): DSNPHRCO 


— End of Internal DB2 Information Powe) 


System Action: DSM terminates its action with the associated 
data set. Higher level functions that issued the recall request 
may terminate. 


Operator Response: Notify the system programmer. 


System Programmer Response: Investigate the reason for the 
HSM recall failure. Use the information in this message to help 
resolve this problem. Additional messages on the MVS opera- 
tor’s console may be associated with this message. 


Problem Determination: If the HSMRSN is 999, refer to the fol- 
lowing list for the explanation: 


HSMRC Description 

4 HSM is not active. 

8 No storage is available for MWE in CSA. 

36 input MWE is not within user storage. 

40 Allocated amount of CSA for MWEs has been 
exceeded. 

100 There was an invalid function used. 


For all other reason codes (HSMRSN), refer to the HSM User’s 
Guide for an explanation of HSM user messages. The HSM 
user messages can be determined by appending the value in 
the HSMRC field of this message to ARC1100I (that is, 

HSMRC= 12, HSM message is ARC1112l). The HSMRSN reason 
code is referenced in the ARC1100! messages. 
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Recovery Manager Messages (DSNBR...) 


The following information messages (DSNRO01I 
through DSNROO6I) indicate the progress of DB2 
through a restart process. 


DSNROO1! RESTART INITIATED 


Explanation: This message delimits the beginning of the 
restart process within startup. The phases of restart are about 
to begin. These phases are necessary to restore the opera- 
tional environment to that which existed at the time of the pre- 
vious termination and to perform any recovery actions that may 
be necessary to return DB2-managed resources to a consistent 
state. 


[ ae Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNRRPRC 


Desens sours End of Internal DB2 Information Bre eed 


DSNROO2E RESTART COMPLETED 


Explanation: This message delimits the completion of the 
restart process within startup. 


eS Internal DB2 Information in) | 
This message is issued by the following CSECT(s): DSNRRPRC 


eee End of internal DB2 Information eet 


DSNRO003! RESTART...PRIOR CHECKPOINT 
RBA = XxxxXXxXxXXXxx 


Explanation: The message indicates the first phase of the 
restart process is in progress and identifies (as 
"XXXXXXXXXXXx') the log positioning RBA of the checkpoint from 
which the restart process will obtain its initial recovery informa- 
tion. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNRRCSR 


ate Bones End of Internal DB2 Information we seta Zl 


DSNROO04| RESTART...UR STATUS COUNTS IN 
COMMIT = nnnn, INDOUBT =nnnn, 


INFLIGHT = nnnn, IN ABORT = nnnn 


Explanation: This message indicates the completion of the first 
phase of the restart process. The counts indicate the number of 
units of work whose execution state during a previous DB2 ter- 
mination was such that (to ensure DB2 resource consistency) 
some recovery action must be performed during this restart 
process. The counts may provide an indication of the time 


required to perform the remaining two phases of restart 
(forward and backward recovery). 


The IN COMMIT count specifies the number that had started but 
not completed phase 2 of the commit process. These must 
undergo forward recovery to complete the commit process. 


The INDOUBT count specifies the number that were interrupted 
between phase 1 and phase 2 of the commit process. These 
must undergo forward recovery to ensure resources modified 
by them are unavailable until their indoubt status is resolved. 


The INFLIGHT count specifies the number that neither com- 
pleted phase 1 of the commit process nor began the process of 
backing out. These must undergo backward recovery to restore 
resources modified by them to their previous consistent state. 


The IN ABORT count specifies the number that were in the 
process of backing out. These must undergo backward 
recovery to restore resources modified by them to their pre- 
vious consistent state. 


[ ~ Internal DB2 Information ~~~ | 
This message is issued by the following CSECT(s): DSNRRCSR 


_ End of Internal DB2 Information ee eee 


DSNROOS! RESTART...COUNTS AFTER FORWARD 


RECOVERY IN COMMIT =nnnn, INDOUBT=nnnn 


Explanation: The message indicates the completion of the 
forward recovery restart phase. The counts indicate the 
number of units of work whose recovery actions could not be 
completed during the phase. Typically, those in an INCOMMIT 
state remain because the recovery actions of some subcompo- 
nents have not been completed. Those units of work in an 
INDOUBT state will remain until connection is made with the 
subsystem that acts as their commit coordinator. 


pe eras Internal DB2 Information SI 
This message is issued by the following CSECT(s): DSNRRHSR 


[ite Sen sea lin End of Internal DB2 Information Soe tol 


Operator Response: No action is required unless the condi- 
tions persist beyond some installation-defined period of time. 
Recovery action will be initiated when the resource is brought 
online. Indoubt resolution will be initiated as part of the 
process of reconnecting the subsystems. 


DSNROOG! RESTART...COUNTS AFTER BACKWARD 


RECOVERY INFLIGHT = nnnn, IN ABORT = nnnn 


Explanation: The message indicates the completion of the 
backward recovery restart phase. The counts indicate the 
number of units of work whose recovery actions could not be 
completed during the phase. Typically, those in either state 
remain because the recovery actions of some subcomponents 
have not been completed. 
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Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNRRAUB 


(ie ee End of Internal DB2 Information ee 


Operator Response: No action is required unless the condition 
persists beyond some installation-defined period of time. 
Recovery action will be initiated when the resource collection is 
brought online. 


DSNROO7E = RESTART...STATUS TABLE 


Explanation: This message precedes a table showing the 
status of units of recovery (URs) after each restart phase. The 
message and the table will accompany the DSNRO04I, 
DSNROOS!I, or DSNROOG6! message after each nested phase. At 
the end of the first phase, it shows the status of any URs that 
require processing. At the end of the second (forward 
recovery) and third (backout) phases, it shows the status of only 
those URs which needed processing but were not processed. 
The table helps to identify the URs that were active when DB2 
came down, and to determine the log scope required to bring 
DB2 up. 


The format of the table is shown below: 
T CONID CORRID AUTHORIZATION ID PLAN S URID DAY TIME 


The columns contain the following information: 
T Connection type. The values may be: 
B Batch: a batch program or QMF user. 


I Internal: a system service being performed 
on some user’s behalf. 


S Subsystem: work that originated from an 
attached subsystem, either CICS or IMS/VS. 


CON-ID Connection identifier for related URs. Batch con- 
nections are not related to any other connection. 
Subsystem connections with the same identifier 
indicate URs that originated from the same sub- 


system. 


CORR-ID Correlation identifier; unique within a subsystem 
connection, it relates a UR to a particular CICS or 


IMS/VS transaction. 


AUTHORIZATION ID 
Authorization identifier of the user for whom this 
UR was created. 


PLAN Name of the plan allocated to the UR. 

S$ Restart status of the UR. When DB2 came down, 
the UR was in one of these situations: 
A INABORT: The UR was in the 


'must-complete' phase of abort, and is 
yet to be completed. 


Cc INCOMMIT: The UR was in the 
‘must-complete' phase of commit, and is 
yet to be completed. 


D INDOUBT: The UR had completed the 
first phase of commit, but DB2 had not 
received the second phase instruction. 
The UR must be remembered so it can 
be resolved when the owning subsystem 
reattaches. 
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F INFLIGHT: The UR had not completed the 
first phase of commit, and will be backed 
out. | 

URID UR identifier, the log RBA of the beginning of this 


unit of work. It is the earliest RBA required to 
process the UR during Restart. 


DAY The day the UR was created, in the format ddd. It 
is approximately the time of the first SQL call of 
the application or the first SQL call following a 
commit point. 


TIME The time the UR was created, in the format hh 
mm ss. It is approximately the time of the first 
SQL cail of the application or the first SQL call 
following a commit point. 


ee Internal DB2 Information = Ss 
This message is issued by the following CSECT(s): DSNRUDIS 


Dot Serepnere se End of Internal DB2 Information oS 


DSNROOSE STORAGE IS NOT AVAILABLE FOR THE UR 
DISPLAY TABLE, 
THE SIZE REQUESTED = xxxx, STORAGE 


MANAGER REASON CODE = yyyyyyyy 


Explanation: There was not enough storage available during 
the creation of the recoverable UR (RURE) display table 
(DSNDRUDT). 


ea Internal DB2 Information oF 
This message is issued by the following CSECT(s): DSNRRCSR 


aes End of Internal DB2 Information een 


System Action: The system continues to restart but the 
RESTART... STATUS TABLE is not displayed. 


System Programmer Response: Increase the region size of the 
..MSTR region before restarting DB2 again. 


Operator Response: Save the console output and inform the 
system programmer. 


Problem Determination: The size requested is approximately 
110 bytes for each unit of recovery (UR). See the message 
DSNROO04I to determine the total number of URs to process. 
Then get the OOE2xxxx reason code from the DSNROOS! header. 
Use these two numbers to determine the reason for the 
shortage. 


DSNRO10i AN ERROR OCCURRED IN THE RURE STATUS 
TABLE SORT/TRANSLATE MODULE (DSNRUSOR), 


THE ERROR LOCATION CODE = xxxx 


Explanation: There was an error in processing the RURE 
display table. One of these ERROR LOCATION CODES tells 
what function the module was attempting to perform: 


X'0001' Trace entry to the module 

X'0002' Sort the recoverable UR display table 
X'0003' Translate the recoverable UR table 
x'0004' Convert the store clock value for display 
X'0005' Trace exit from the module 


Internal DB2 Information “FI 
This message is issued by the following CSECT(s): DSNRRCSR 


————e End of internal DB2 Information es 


System Action: The system continues to restart but the 
RESTART... STATUS TABLE is not displayed. 


System Programmer Response: Use the error code in the 
message to fill in the problem description. 


Operator Response: Save the console output and inform the 
system programmer. 


Problem Determination: The ERROR CODE tells the problem 
area and should be used in the problem description. A record 
was added to the SYS1.LOGREC that contains the PSW and 
module at the time of the error. This error indicates an applica- 
tion program check of some type. 


DSNRO11i AN ERROR OCCURRED IN THE RURE STATUS 
TABLE DISPLAY MODULE (DSNRUDIS), THE 


ERROR LOCATION CODE = xxxx 


Explanation: There was an error in processing the RURE 
display table. One of these ERROR LOCATION CODES tells 
what function the module was attempting to perform: 


X'0001' Trace entry to the module 

X'0002' Build header for the display table 
X'0003' Build entries for the display table 
X'0004' Call DSNRWTO to display the table 
X'0005' Trace exit from the module 
X'0006' Get message text 


[ ao internal DB2 Information | 


This message is issued by the following CSECT(s): DSNRRCSR, 
DSNRRHSR, DSNRRAUB 


rT End of internal DB2 information bettas SNe al 


System Action: The system continues to restart but the 
RESTART... STATUS TABLE is not displayed. 


System Programmer Response: Use the error code in the 
message to fill in the problem description. 


Operator Response: Save the console output and inform the 
system programmer. 


Problem Determination: The ERROR CODE describes the 
problem area and should be used in the problem description. A 
record was added to the SYS1.LOGREC containing the value 
DSNRUDIS, and the PSW and CSECT at the time of the error. 
This error indicates an application program check of some type. 


Error codes other than X'0006' indicate an application program 
check of some type. Code X'0006' indicates an error 
attempting to locate the table text. The trace entry for 
DSNRUDIS contains the return and reason codes from the Get 
Text request. That information should be used to fill in the 
problem description. 
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DSNRO141 EXCLUDED RURE TABLE 


Explanation: This is a list of RUREs which are being bypassed 
because of the conditional restart. Either they were to be proc- 
essed in a phase that was bypassed or they were outside the 
log range. 


The following shows the format of the table headings. See 
message DSNR0O07! for an explanation of the table columns. 
T CONID CORRID AUTHORIZATION ID PLAN S URID DAY TIME 


System Action: Restart continues. 


DSNRO15| THE CHKPTRBA xxxxxxxxxxxx SPECIFIED IN THE 


CRCR IS INVALID 


Explanation: The checkpoint RBA specified in the conditional 
restart control record (CRCR) is either not available or is not a 
begin checkpoint record. 


| Internal DB2 Information | 
This message issued by the following CSECT(s): DSNRITO3 


Seer: End of internal DB2 Information _ 


System Action: Restart is abended with reason code 
‘90D99001'. 


Operator Response: Inform the system programmer. 


System Programmer Response: By specifying the STARTRBA 
and/or ENDRBA on the CRESTART control statement, Change 
Log Inventory selects an appropriate RBA. 


Problem Determination: Print the complete checkpoint records 
queue by using PRINT LOG MAP. Select a checkpoint RBA 
from this queue or let Change Log Inventory make the 
selection. 


DSNRO16I STARTRBA xxxxxxxxxxxx VALIDATION FAILED 


Explanation: A scan from the STARTRBA failed to find a com- 
plete log record. Either the entire log was scanned and no 
complete record was found, or the Log Manager found an 
invalid log record. The Log Manager sends the error messages 
to the console indicating a bad log record. 


System Action: Restart abends. 


Operator Response: Record the Log Manager message 
numbers and inform the system programmer. 


System Programmer Response: Use DSN1LOGP to determine 
a STARTRBA to use for restart. The Recovery Manager uses the 
STARTRBA as a starting point for its search of the beginning of 
a valid log record. 


DSNRO17| RESTART IS BEING TERMINATED BECAUSE OF 


CSRONLY SPECIFICATION IN CRCR 


Explanation: The restart procedure only completed the first 
phase of startup. The status displayed during this partial 
restart can be used to build the conditional restart control 
record (CRCR). 


System Action: Restart is abended. 


System Programmer Response: To prevent the restart control 
record from being reused during the next restart attempt, the 
current restart contro! record must be canceled. Use the 
Change Log Inventory CRESTART CANCEL option or CREATE a 
new restart contro! record. The newly created restart control 
record will automatically cancel the previous record. 
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DSNT1011 — DSNT1031 





Service Controller and Installation Messages (DSNT...) 


Service Controller Message 
Severity Codes 


Messages issued by DSNTINST, DSNTINS1, 
DSNTINS2, DSNTINM1, and DSNTINM2 installation 
CLISTs have an internal severity level as follows: 


0 Successful execution: CLIST progress 
and tracing messages (processing con- 
tinues) 

4 Warning: some adjustments may be made 


by the installation CLISTs (processing 
and JCL editing continues) 


8 Error: unable to continue (no JCL is 
edited) 
DSNT1011 A VSAM ERROR HAS BEEN ENCOUNTERED 


WHILE READING THE DB2 BSDS 
VSAM RETURN CODE = x, 
VSAM REASON CODE = y 


Explanation: CSECT DSNTSTR2 attempted to read the DB2 
bootstrap data set (BSDS), and a VSAM error has occurred. In 
the message, 'x' is a 1-byte VSAM return code and ‘y' isa 
1-byte VSAM reason code. 


| Internal DB2 Information oH 
This message is issued by the following CSECT(s): DSNTSTR2 


| Ss End of Internal DB2 Information _____———i 


System Action: The DB2 start up process continues. However, 
any references to DB2 password-protected system databases 
will cause a ‘resource unavailable‘ error. Any agent-related 
requests for DB2 subsystem database resources will result in 
an SQLCODE of -904. Any non-agent-related requests for una- 
vailable resources will result in the following messages: 


DSNIOO1! DSNIO02! DSNI003! 
DSNIOO4I DSNIO05! DSNIOO6I 
DSNT408I DSNT414I DSNT4151 
DSNT416I DSNT417I DSNT5001 


Abend X'04E' with reason code X'00E30010' is also produced. 
However, the error results in a retry. DB2 does not terminate, 
but a dump is produced. 


Operator Response: Notify the system programmer. 


System Programmer Response: A VSAM error occurred while 
reading the BSDS record with key '200000001'. Either the 
BSDS record does not exist or an I/O error occurred (indicating 
that the record is bad). Further information may be obtained 
from a VSAM diagnostics manual. Refer to Section 5 (Volume 
2) of Administration Guide for procedures on recovering or 
repairing the DB2 bootstrap data set. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 15. 


DSNT1021 AN INVALID DATABASE SERVICES BOOTSTRAP 


RECORD HAS BEEN ENCOUNTERED 


Explanation: CSECT DSNTSTR2 attempted to read the DB2 
bootstrap data set (BSDS), and an invalid record was read by 
the recovery log manager (RLM) subcomponent. This is a DB2 
error. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTSTR2 


a es End of Internal DB2 information fe soa te ot 


System Action: The DB2 start up process continues. However, 
any references to DB2 password-protected system databases 
will cause a 'resource unavailable’ error. Any agent-related 
requests for DB2 subsystem database resources will result in 
an SQLCODE of -904. Any non-agent-related requests for una- 
vailable resources will result in the following messages: 


DSNIO01! DSNIO02I DSNIO03! 
DSNI004I DSNIOOSI DSNIOO6I 
DSNT408! DSNT4141 DSNT4151 
DSNT416l DSNT4171 DSNT500! 


Abend X'04E' with reason code X'00E30010' is also produced. 
However, the error results in a retry. DB2 does not terminate, 
but a dump is produced. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: This message is generated when the 
recovery log manager (RLM) subcomponent of DB2 encounters 
an invalid DB2 database services password record. A copy of 
the BSDS record with key '200000001', which is the invalid 
database services record retrieved, shouid be obtained. 


Collect the following diagnostic items fisted in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 15. 


DSNT1031 THE CURRENTLY LOADED DSN6SPRM IS NOT 


THE MVS/XA VERSION 


Explanation: A -START DB2 PARM = xxxxxxxx was issued -° 
where 'xxxxxxxx' is the version of the system parameter 
CSECTs. DB2 executes in a MVS/XA environment and will not 
execute in any other environment. 


| internal DB2 Information ] 
This message is issued by the following CSECT(s): DSNTSTR2 


fee End of Internal DB2 Information see oe 


System Action: The message DSNVO86E is generated with a 
reason code of X'00E30008'. DB2 is terminated with abend 
code X'04F'. 


DB2 Messages 3-121 


DSNT105!1 — DSNT201I 


Operator Response: Notify the system programmer. 


System Programmer Response: Restart DB2 with a -START 
DB2 PARM= command, where the parameter block that follows 
the 'PARM=' parameter specifies an MVS/XA version of the 
DB2 subsystem parameters. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


DSNT105! THE LOADED DSN6SPRM CSECT IS OBSOLETE. 
PLEASE REASSEMBLE THE DSN6SPRM CSECT 
AND RELINKEDIT THE DSNZPARM LOAD 


MODULE. 


Explanation: DSNTSTR2 loaded an out-of-date system param- 
eter CSECT DSN6SPRM. This error can only occur if code 
maintenance has been applied and CSECT DSN6SPRM has not 
been reassembied. This CSECT is contained in the load 
module specified inthe ‘PARM= ' parameter of the -START 
DB2 command. 


| Internal DB2 Information as i 
This message is issued by the following CSECT(s): DSNTSTR2 


Rete aan End of Internal DB2 Information ete 


System Action: The message DSNVO8G6E is generated with a 
reason code of X'00E30008'. DB2 is terminated with abend 
code X'04F'. 


Operator Response: Notify the system programmer. 


System Programmer Response: Reassembie DSN6SPRM, and 
relink-edit the DSNZPARM load module. This is done by resub- 
mitting the install job stream, DSNTIJUZ, that built the load 
module that is named following the 'PARM= ' parameter of the 
-START DB2 command. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2,3, 5,9. 


DSNT1061 THE LOADED DSNG6SYSP CSECT IS OBSOLETE. 
PLEASE REASSEMBLE THE DSN6SYSP CSECT 
AND RELINKEDIT THE DSNZPARM LOAD 


MODULE. 


Explanation: DSNTSTR2 loaded an out-of-date system param- 
eter CSECT DSN6SYSP. This error can only occur if code main- 
tenance has been applied and CSECT DSN6SYSP has not been 
reassembled. This CSECT is contained in the load module 
specified in the 'PARM=' parameter of the -START DB2 
command. 


| internal DB2 information 
This message is issued by the following CSECT(s): DSNTSTR2 


ee eee ee End of Internal DB2 Information eee el 


System Action: The message DSNVO8GE is generated with a 
reason code of X'00E30008'. DB2 is terminated with abend 
code X'04F'. 


Operator Response: Notify the system programmer. 


System Programmer Response: Reassemble DSN6SYSP, and 
relink-edit the DSNZPARM load module. This is done by resub- 
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mitting the install job stream, DSNTIJUZ, that built the load 
module that is named following the 'PARM=' parameter of the 
-START DB2 command. 


Problem Determination: Coilect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


INVALID AMODE OR RMODE ATTRIBUTE FOUND 
FOR LOAD MODULE module-name 


DSNT1071 


Explanation: During DB2 startup, the service controller estab- 
lishes the addressability to the DB2 database services func- 
tional recovery and the emergency shutdown routines. Two 
load modules, DSNTF, and DSNTLCLE, are loaded into CSA. in 
the MVS/XA environment, DSNTLCLE must be link-edited with 
attributes AMODE(24) and RMODE(ANY). At least one of the 
modules did not have the correct addressing attribute when it 
was loaded. 'module-name' in the error message is the name 
of the first load module that has an invalid addressing mode. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTSTRT 


ee End of Internal DB2 Information ae 


System Action: DB2 database services start up is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Verify that all install and 
maintenance activities against these modules were executed 
using SMP. Verify that the JCLIN for SMP includes the correct 
AMODE and RMODE control statements, and that the linkage 
editor provided with the Data Facility Product (DFP) was 
invoked by SMP for the link edits. Correct the procedure or JCL 
which caused the error and rerun the necessary SMP jobs. 


Problem Determination: A DB2 dump was requested to an 
MVS/XA SYS1.DUMP data set. 


The MVS/XA service aid AMBLIST provides linkage editor 
module attributes in the summary section of the LISTLOAD 
function output. 


DSNT200I type bind-type FOR PLAN plan-id SUCCESSFUL 
Explanation: A BIND subcommand has completed successfully. 


type Indicates that a test bind was in progress. The token 
is omitted if a normal bind, rebind or free was proc- 
essed. 


bind-type Type of BIND subcommand: BIND, REBIND, FREE. 


plan-id Name of application plan specified in the BIND sub- 
command. 
DSNT2011 type bind-type FOR PLAN plan-id NOT SUC- 


CESSFUL 


Explanation: Errors have been detected during the processing 
of the indicated BIND subcommand. 


type Indicates that a test bind was in progress. The token 
is omitted if a normal bind, rebind or free was proc- 
essed. 


bind-type Type of BIND subcommand: BIND, REBIND, FREE. 


Name of application plan specified in the BIND. sub- 


plan-id 
, command. 


System Programmer Response: See other messages issued to 
determine the error that caused the BIND subcommand to be 
terminated unsuccessfully. 


DSNT202I _bind-type FOR PLAN plan-id USING 
authorization-id AUTHORITY EXCEEDED 
MESSAGE LIMIT. MESSAGE GENERATION TERMI- 


NATED 


Explanation: A fixed amount of space exists in which to gen- 
erate BIND subcommand messages. This message indicates 
that the indicated BIND subcommand generated more mes- 
sages than will fit in that space. 


bind-type Type of BIND subcommand: BIND, REBIND, FREE. 


plan-id Name of application plan specified in the BIND sub- 


command. 


authorization-id 
Authorization ID of the invoker of the BIND subcom- 
mand. 


System Action: The BIND subcommand process continues. 
However, no other messages are generated for the indicated 
‘plan-id', except for message DSNT200I or DSNT2011. 


System Programmer Response: The 'FLAG' parameter of the 
BIND subcommand may be used to limit the types of messages 
that are generated. 


DSNT2051 name IS A DUPLICATE name-type, IT WILL BE 


USED ONLY ONCE 


Explanation: Name 'name' has been specified more than once 
in a list of names. 


name Name that was specified more than once. 


name-type Type of list in which the name was dupli- 


cated: MEMBER NAME or PLAN-ID. 


System Action: Duplicates are removed from the list of names 
and the bind process continues. 


User Response: Verify the list that contains the duplicate. If 
the duplicate is the result of a misspelling or typographical 
error, correct the entry and reissue the BIND subcommand. If 
the list of unique names is compiete, no action is required. 


DSNT207! PROGRAM program-name WITH MARK release- 
dependency-mark FAILED BECAUSE IT DEPENDS 
ON FUNCTIONS OF THE RELEASE FROM WHICH 


FALL BACK HAS OCCURRED 


Explanation: Program 'program-name' depends on a function 
of DB2 that is not supported by the current active release. 


program-name 
Name of the application program. 


release-dependency-mark 
A 1-character mark showing the oldest DB2 release 
supporting this application program. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTBCM1 


[eae Sal eee? End of Internal DB2 Information ee | 


DSNT202!1 — DSNT209I 


System Action: The BIND operation for this plan is not per- 
formed. 


User Response: The application program cannot be used until 
the DB2 subsystem is remigrated to the newer release. 


Operator Response: Notify the system programmer. 


System Programmer Response: Warn users not to use plans 
containing this application program until the DB2 subsystem 
has been remigrated to the newer release. 


DSNT208I PROGRAM program-name PRECOMPILED WITH 


INCORRECT LEVEL FOR THIS RELEASE 


Explanation: Program 'program-name' was precompiled 
under a release not supported by the current level of DB2, or 
the contents of the DBRM have been modified after the precom- 
pilation phase. 


| Internal DB2 information | 
This message is issued by the following CSECT(s): DSNTBCM1 


—— End of Internal DB2 Information ete 


User Response: Precompile the named program again using 
the current precompiler. Reissue the BIND command. 


Problem Determination: Ifthe application program was pre- 
compiled at an appropriate release, and the problem persists, 
collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 78, 79, 80. 


DSNT2091 bind-type FOR PLAN plan-id WITH MARK release- 
dependency-mark FAILED BECAUSE PLAN 
DEPENDS ON FUNCTIONS OF THE RELEASE 


FROM WHICH FALL BACK HAS OCCURRED. 


Explanation: Plan 'plan-id' depends on a function of DB2 
which is not supported by the currently active release. 
bind-type REBIND 

plan-id Name of the application plan 


release-dependency-mark 
A one-character mark showing the oldest release of 
DB2 which can support this plan. The release 
dependency mark for the plan is kept in the 
IBMREQD columns in the DB2 catalog in 
SYSIBM.SYSPLAN. 


| Internal DB2 Information aa te 
This message is issued by the following CSECT(s): DSNTBRB 


Upc Sess End of internal DB2 Information eee teat) 


System Action: The REBIND operation for this plan is not per- 
formed. 


User Response: The pian cannot be used until the DB2 sub- 
system is remigrated to the newer release. 


Operator Response: Notify the system programmer. 


System Programmer Response: Warn users not to use the 
plan until the DB2 subsystem has been remigrated to the newer 
release. 
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DSNT2101 — DSNT2211 


DSNT2101 bind-type AUTHORIZATION ERROR 
USING authorization ID AUTHORITY 
PLAN = pian-id 

Explanation: !f a 'plan-id' is not indicated, the indicated 


authorization ID does not have the authority to invoke any BIND 
subcommand. If a 'plan-id' is indicated, the authorization ID 
does not have the authority to invoke the indicated BIND sub- 
command against the indicated application plan. 


bind-type Type of BIND subcommand: BIND, REBIND, FREE. 


authorization ID 
Authorization ID of the plan owner. 


plan-id Application plan specified in the BIND subcommand. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNTBAP1 DSNTBCM1 DSNTBFR 
DSNTBRB 


re End of Internal DB2 Information ee 


System Action: The BIND, REBIND, or FREE operation for 
'plan-id' is not performed. 


System Programmer Response: Ifa 'plan-id' is not indicated, 
the privilege to invoke the BIND subcommand with the 
ACTION(ADD) option must be granted to the indicated authori- 
zation ID. If a 'plan-id' is indicated, the privilege to invoke a 
BIND subcommand against the indicated application plan must 
be granted to the indicated authorization ID. 


DSNT2111 REBIND OF PLAN plan-id FAILED BECAUSE 


IBMREQD OF ibmreqd IS INVALID. 


Explanation: The IBMREQD column of the SYSIBM.SYSPLAN 
catalog table for the named pian contains an unrecognizable 
character. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTBRB 


[i ee See oe End of Internal DB2 Information lee ees 


System Action: The REBIND failed. 


User Response: You must do a BIND ACTION(REPLACE) for 
this plan. 


DSNT212I bind-type AUTHORIZATION ID authid IN THE 


OWNER KEYWORD IS INVALID 


Explanation:. The authorization ID specified in the OWNER 
keyword of the BIND or REBIND subcommand must be either 
the user’s primary authorization !D or one of the associated 
secondary authorization IDs. The 'bind-type' is either 'BIND' 
or 'REBIND'. 
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Internal DB2 Information oe i 


This message is issued by the following CSECT(s): DSNTBCM1, 
DSNTBRB 


{|S seEnd of internal DB2 Information _____————_| 


System Action: The BIND or REBIND subcommand is not exe- 
cuted. 


User Response: Rerun the subcommand and specify a valid 
authorization ID for the OWNER keyword. Use the primary 
authorization ID for BIND or the previous owner for REBIND. If 
left blank, the primary authorization ID will be used. 


System Programmer Response: You may need to add the 
required authorization !D for this user to the security system. 


DSNT213I THE DCB BLOCK SIZE OF THE INPUT DBRM 


LIBRARY IS INVALID 


Explanation: An invalid DCB block size is specified for the 
DBRM library of the BIND subcommand. 


[ Internal DB2 Information Te as | 
This message is issued by the following CSECT(s): DSNTBAP1 


eae tes het End of Internal DB2 Information etter 


System Programmer Response: Correct the DCB block size of 
the DBRM library, and reissue the BIND subcommand. 


DSNT220i BIND ADD ERROR USING auth-id AUTHORITY 


PLAN plan-id ALREADY EXISTS 


Explanation: An attempt was made to use the BIND subcom- 
mand with the 'ACTION(ADD)' option that specified a '‘plan-id' 
that already exists. 


authorization ID 
Authorization ID of the invoker of the BIND subcom- 
mand. 


plan-id 


[ ~~ _ Internal DB2 Information ~~~ — = | 
This message is issued by the following CSECT(s): DSNTBCM1 


De hoes ee End of Internal DB2 Information ae ey 


System Action: No application plan is created. 


System Programmer Response: Check the SYSIBM.SYSPLAN 
catalog table for names of existing application plans. Reinvoke 
the BIND subcommand with a 'plan-id' that is not in use. 


Application plan specified in the BIND subcommand. 


DSNT2211 _—ibind-type ERROR USING auth-id AUTHORITY 


PLAN pian-id DOES NOT EXIST 


Explanation: The indicated BIND subcommand was issued 
against an application plan that does not exist. The individual 
variable fields contain: 


bind-type Type of BIND subcommand: REBIND, FREE. 


authorization ID Authorization ID of the invoker of the BIND sub- 
command. 


plan-id Application plan specified in the BIND subcommand. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): DSNTBFR, 
DSNTBRB 


[Ss End of internal DB2 Information ___——_ 


System Programmer Response: Check the SYSPLAN catalog 
table for the correct 'plan-id' to use. 


BIND DBRM MEMBER NAME ERROR 

USING authorization id AUTHORITY 

PLAN = plan-id MEMBER dbrm-member-name 
NOT FOUND IN PDS SEARCH ORDER 


DSNT2301 


Explanation: The indicated 'dbrm-member- name' was not 
found in search order in the PDSs specified on the BIND sub- 
command. 


authorization id 
Authorization ID of the invoker of the BIND subcom- 


mand. 
plan-id Application plan specified in the BIND subcommand. 


dbrm-member-name 
Member name of the DBRM that was not found. 


[ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTBAP1 


LE nd of Internal DB2 information ____———_—| 


System Action: No application plan is created. 


System Programmer Response: Determine if an incorrect 
‘dbrm-member-name' or PDS was specified. Reinvoke the 
BIND subcommand specifying the correct names. 


DSNT2311 BIND DBRM ERROR HAS OCCURRED DBRM 
dbrm-name IS IN AN INCONSISTENT STATE 
AUTHORIZATION ID = authorization-id 


PLAN = plan-id 


Explanation: The contents of a DBRM have been modified after 
the precompilation process. 


dbrm-name 
Name of the DBRM that is in error. 


authorization-id 
Authorization ID of the invoker of the BIND subcom- 
mand. 


plan-id Application plan specified in the BIND subcommand. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTBAP1 


[End of internal DB2 Information 


System Action: No application plan is created. 


System Programmer Response: Precompile the application 
program associated with the indicated DBRM. Reinvoke the 
BIND subcommand. 


DSNT230I — DSNT252i 


DSNT250! BIND UNABLE TO OPEN DBRM LIBRARY 
USING authorization-id AUTHORITY 


PLAN = plan-id 


Explanation: The BIND subcommand was unable to open the 
DBRM partitioned data set(s). 


authorization-id 
Authorization ID of the invoker of the BIND subcom- 
mand. 


plan-id Application plan specified in the BIND subcommand. 


.<- — Internal DB2 Information a 7 ee 
This message is issued by the following CSECT(s): DSNTBAP1 


[End of Internal DB2 Information 


User Response: Contact the system programmer, providing ali 
material associated with the error. 


System Programmer Response: Determine why the BIND sub- 
command was unable to open the DBRM library, and correct 
the problem. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 31. 


DSNT251I BIND UNABLE TO LOCATE DBRM LIBRARY 
MEMBERS USING authorization-id AUTHORITY 


PLAN = plan-id 


Explanation: The BIND subcommand received an I/O error 
while attempting to locate the specified DBRM library 
member(s). 


authorization-id 
Authorization ID of the invoker of the BIND subcom- 
mand. 


plan-id Application plan specified in the BIND subcommand. 


| : Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTBAP1 


ae End of Internal DB2 Information dd 


System Programmer Response: Correct the reason for the I/O 
error, and reissue the BIND subcommand. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 31. 


DSNT252! bind-type PARAMETERS FOR PLAN plan-name 
ACTION bind-option1 bind-option2 
OWNER bind-option3 
VALIDATE bind-option4 
ISOLATION bind-option5 
ACQUIRE bind-option6 
RELEASE bind-option7 
EXPLAIN bind-option8’ 


Explanation: The pian specified by plan-name has the listed 
BIND/REBIND options. 
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DSNT2531 — DSNT303! 


| internal DB2 Information a | 


This message is issued by the following CSECT(s): DSNTBRB, 
DSNTBCM1 


eat End of Internal DB2 Information fee ee, eet 


Severity: 0 (informational) 


System Action: This message indicates the options that were 
used for the specified plan during BIND/REBIND processing. 


DSNT253! 


bind-type PARAMETERS FOR PLAN pian-name 
DEFER bind-option1 
NODEFER bind-option2 


Explanation: The plan specified by plan-name has the listed 
BIND/REBIND options. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNTBRB, 
DSNTBCM1 


eee ae End of Internal DB2 Information eet Sau a 


Severity: 0 (informational) 


System Action: This message indicates the options that were 
used for the specified plan during BIND/REBIND processing. 


DSNT260I REBIND - THE SUBMITTED PARAMETERS 
RESULT IN AN INVALID COMBINATION OF 
ACQUIRE(ALLOCATE) AND RELEASE(COMMIT) 


FOR PLAN plan-id. 


Explanation: The REBIND subcommand has been submitted 
with one of the following: 


¢ A REBIND parameter equal to ACQUIRE(ALLOCATE) and 
the RELEASE column of the SYSPLAN table for PLAN 
‘plan-id' equal to COMMIT 


¢ A REBIND parameter equal to RELEASE(COMMIT) and the 
ACQUIRE column of the SYSPLAN table for PLAN 'plan-id' 
equal to ALLOCATE. 


The combination ACQUIRE(ALLOCATE) RELEASE(COMMIT) is 
not supported by DB2. 


| —~ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNTBRB 


eA ae, aed End of Internal DB2 Information eae coon 


System Action: 
plan. 


The REBIND process is terminated for this 


User Response: Rebind the plan 'plan-id' with the correct 
parameters. Refer to Chapter 2 of Command and Utility Refer- 
ence for additional information regarding the REBIND subcom- 
mands. 


Problem Determination: 
message. 


See the Explanation section of this 
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DSNT3001 AUTH-ID authorization-id NOT AUTHORIZED TO 


PERFORM function ON DATABASE dbname. 
REQUEST REJECTED 


Explanation: The invoker’s ‘authorization-id' as designated by 
AUTHORIZATION ID is not authorized to perform the specified 
database control command function on this database. The 
‘function’ is either -START, -STOP, or -DISPLAY. The name of 
the database is 'dbname'. 


as Internal DB2 Information a | 
This message is issued by the following CSECT(s): DSNTDMSG 


bore End of Internal DB2 Information eee eS 


System Action: The request is rejected. 
User Response: Notify the system programmer. 


System Programmer Response: The privilege to issue the 
command must be granted to the indicated 'authorization-id'. 


DSNT301i [INVALID DATABASE dbname 


Explanation: The databases named in the -START, -STOP, or 
-DISPLAY DATABASE command do not exist. The name of the 
database is 'dbname'. 


System Action: The request is rejected. This message may be 
repeated. 


as ee internal DB2 information a, | 
This message is issued by the following CSECT(s): DSNTDMSG 


eet er End of Internal DB2 Information re 


System Programmer Response: Reissue the command with a 
valid name. 


DSNT3021 INVALID NAME spname 


Explanation: In the message, 'spname’ is the name of the 
table space or index space. The 'spname' specified in the 
SPACENAM keyword on the -START, -STOP, or -DISPLAY DATA- 
BASE command does not exist. 


System Action: The request is rejected. This message may be 
repeated. 


| 7 - Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNTDMSG 


Des ee End of Internal DB2 Information es 


System Programmer Response: Reissue the command with a 
valid table space name or index name. 


DSNT3031 SPACENAM KEYWORD ONLY VALID FOR A 


SINGLE DATABASE. REQUEST REJECTED 


Expianation: The SPACENAM keyword may be specified only 
when a single database name is specified for the DATABASE 
keyword in the -START, -STOP, and -DISPLAY DATABASE 
command. 


DSNT305!1 — DSNT309I 


| | Internal DB2 Information | | Internal DB2 Information “| 


This message is issued by the following CSECT(s): DSNTDMSG 


ete eee End of Internal DB2 Information a 


System Action: The request is rejected. 


System Programmer Response: Reissue the command, speci- 
fying a single database name inthe 'DATABASE' keyword. 


DSNT3051 SUBSYSTEM FAILURE DURING command-name 
DATABASE COMMAND PROCESSING. RC = yy, 


REASON = zz 


Explanation: An error was found while processing the -START, 
-STOP or -DISPLAY DATABASE command. In the message, 
‘command-name' is the string 'DISPLAY', 'STOP', or 
'START' (depending upon the command processed). 


[ Internal DB2 Information : | 
This message is issued by the following CSECT(s): DSNTDMSG 


faa ee End of Internal DB2 Information oe ee 


System Action: Originating from CSECT DSNTDCST: 


¢ For relational data system (RDS) subcomponent errors: 
— 'yy’' is a 4-byte return code of 8. 
— 'zz' is a 4-byte abend code of '00E30085'. 

¢ For data manager (DM) subcomponent errors: 

— 'yy' is a 4-byte return code consisting of a 2-byte return 
code and a 2-byte reason code returned by the data 
manager function invoked by DSNTDCST. 

— 'zz' is a 4-byte abend code '00E30086'. 


A record is written to SYS1.LOGREC, and an SVC dump 
is requested before the execution unit is abended. 


Originating from CSECT DSNTDDIS: 


e 'yy' is a 4-byte return code of 12. 
¢ 'zz' is a 4-byte abend code of '00E30089'. 


The request is abended. 
Originating from CSECTs DSNTDMUL or DSNTDMSG: 


e 'yy' is a 4-byte return code returned by the message gen- 
erator. 
e ‘2z' is a 4-byte abend code of '00E30084'. 


The request is abended. 


System Programmer Response: Refer to “Section 4. DB2 
Codes” on page 4-1 for the particular abend reason code 
issued. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 16. 


DSNT306I 


Explanation: A fixed amount of space exists in which to gen- 
erate DISPLAY, START, or STOP database command messages. 
This message indicates that the DISPLAY, START, or STOP 
database command that was specified generated more mes- 
sages than will fit in that space. 


RESPONSE MESSAGE LIMIT HAS BEEN REACHED 


| 
| 


This message is issued by the following CSECT(s): DSNTDMSG 
a End of Internal DB2 Information Sa 


User Response: Specify individual databases and/or table 
spaces rather than specifying '*' (that is, all names). 


DSNT307i INVALID RANGE SPECIFICATION string1 IS 


GREATER THAN string2 


Explanation: A range was specified on a DISPLAY 
DB(string1:string2) or DISPLAY DB(..) 
SPACENAM(string1:string2) command where the first string, 
specified alphanumerically, collates after the second string. 


[es internal DB2 Information ae 
This message is issued by the following CSECT(s): DSNTDMSG 


tees End of Internal DB2 Information see ets] 


User Response: Specify the command again. Make sure the 
first string does not alphanumerically collate after the second 
string specified. 


DSNT308i AFTER KEYWORD ONLY VALID FOR A SINGLE 


DATABASE OR A SINGLE 
TABLESPACE/INDEXSPACE WITHIN A DATABASE. 
REQUEST REJECTED 


Explanation: The AFTER keyword may be specified by one of 
the following: 


e Asingle database name after the keyword DATABASE 


¢ Asingle table space name or index space name after the 
keyword SPACENAM. 


Interna! DB2 Information | 
This message is issued by the following CSECT(s): DSNTDMSG 


as End of Internal DB2 Information soe ne | 


User Response: Specify the command correctly. 


object name IS CURRENTLY state. NO ACTION 
TAKEN FOR THIS object. 


DSNT3091 


Explanation: One of the following is already in the requested 
State: 


¢ A database listed in START DB(list) or STOP DB(list) 


e A table space listed in START DB(name) SPACENAMilist) or 
STOP DB(name) SPACENAM({list) 


¢ An index space listed in START DB(name) SPACENAM(list) 
or STOP DB(name) SPACENAM(list). 
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DSNT3101 — DSNT313i 


In the message: 
* The '‘object' is either: 


— TABLESPACE if the specified table space was currently 
in the requested state 


— INDEXSPACE if the specified index space was currently 
in the requested state 


~ DATABASE if the database was currently in the 
requested state. 


* The 'name' is the database, table space, or index space. 
e The 'state' is either: 


— START RW if the specified table space is currently 
started read/write 


— START RO if the specified table space is currently 
started read only 


— START UT if the specified table space is currently 
started for utility processing 


~ STOPPED if the specified table space is currently 
stopped, has a stop pending against it, or is stopping. 


" Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTDMSG 


[ete ee End of Internal DB2 Information ee ee 


User Response: Specify the command correctly. 


DSNT3101I ALL object CURRENTLY state. NO ACTION 


TAKEN. 


Explanation: A database and ail of its table spaces and index 
spaces are already in the requested state. This occurred fol- 
lowing the processing of one of these commands: 


¢ START DB(*) 

* STOP DB(name) 

¢ START DB(name) SPACENAM(*) 
¢ STOP DB(name) SPACENAM(*). 


In this message: 
* The ‘object' is either: 


~ TABLESPACE(S) if the specified table space was cur- 
rently in the requested state 


- INDEXSPACE(S) if the specified index space was cur- 
rently in the requested state 


— DATABASE(S) if the database was currently in the 
requested state. 


¢ The ‘state’ is either: 


— START RW if the specified table space is currently 
started read/write 


— START RO if the specified table space is currently 
started read only 


— START UT if the specified table space is currently 
started for utility processing 


— STOPPED if the specified table space is currently 
stopped, has a stop pending against it, or is stopping. 
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| Internal DB2 Information ae 
This message is issued by the following CSECT(s): DSNTDMSG 


[ites ie oe End of {Internal DB2 information a Fret 


User Response: Specify the command correctly. 


DSNT311I MESSAGE LIMIT EXCEEDED. DISPLAY IS TERMI- 


NATED. 


Explanation: The number of messages generated exceeds the 
maximum number of messages specified in the LIMIT keyword 
or exceeds the system default. 


Internal DB2 Information _ | 
This message is issued by the following CSECT(s): DSNTDMSG 


Gece ete | End of Internal DB2 Information ease | 


DSNT312i object DSNDB05 MUST BE STARTED RW. NO 


ACTION TAKEN. 


Explanation: The ACCESS keyword is either RO or UT, and one 
of the following applies: 


¢ DSNDBO5 is listed in the START DB(list). 


e The table spaces for the DSNDBO5 are listed in the START 
DB(DSNDB05) SPACENAMilist). 


® The index spaces for the DSNDBO5 are listed in the START 
DB(DSNDBO5) SPACENAM (list). 


In the message, ‘object' is either: 


¢ TABLESPACE(S) IN if the START DB(DSNDBO5) 
SPACENAM(...) is specified 


¢ DATABASE if the START DB(DSNBD05) is specified. 


as Internal DB2 Information a tt 
This message is issued by the following CSECT(s): DSNTDMSG 


ee es End of Internal DB2 Information 2 cos Al 


DSNT3131 ACCESS(FORCE) IS VALID ONLY WITH EXPLICIT 


TABLESPACE OR INDEXSPACE NAMES. 
COMMAND IS REJECTED. 


Explanation: The ACCESS(FORCE) keyword can be specified 
when either: 


e Asingle table space or index space name appears after the 
keyword SPACENAM in a START DATABASE command. 


° A list of table space and/or index space names appears 
after the keyword SPACENAM in a START DATABASE 
command. 


| ~ Internal DB2 Information ~~ a 7 
This message is issued by the following CSECT(s): DSNTDMSG 


es End of Internal DB2 Information gee 


Operator Response: Specify the command correctly. 


DATABASE name AND ANY SPACE IT CONTAINS 
CANNOT BE STOPPED. !T IS THE ACTIVE COM- 
MUNICATIONS DATABASE. 


DSNT3311 


Explanation: The database specified in the message cannot be 
stopped because it is the active communications database. 
Furthermore, spaces within the active communications data- 
base cannot be stopped. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTDCST 


a End of Internal DB2 Information Se 


System Action: Nothing is stopped. 
User Response: See Operator Response. 


Operator Response: The named database cannot be stopped | 
because it is the communications database, nor can any spaces 
contained in the database be stopped. If the database or any 

space within it must be stopped, then the distributed data 

facility must be stopped (STOP DDF). 


TABLESPACES AND INDEXSPACES ARE UNA- 
VAILABLE BECAUSE DATABASE name !S 
STOPPED 


DSNT332I 


Explanation: The database 'name' is currently marked as 
stopped. Consequently, its table spaces and index spaces are 
unavailable even though they may have been started. 


| internal DB2 information ~ OY 
This message is issued by the following CSECT(s): DSNTDMSG 


Wee ase oe ge End of internal DB2 Information oie ee 


DSNT3501 —luw-id ACCESSING DATA FOR location 


Explanation: This message is issued following message 
DSNT3941 or DSNT396I for each thread reported that is partic- 
ipating in distributed data access (allied thread or database 
access thread). This additional line reports the distributed 
identification as follows: 
luw-id = token 
The logical-unit-of-work identifier (LUW-ID) is a | 
unique identifier that is assigned to the thread fol- | 
lowed by an '=' sign and a token. The token may 
be used in place of luw-id in any DB2 command that 
accepts luw-id as input. 


location The LOCATION name assigned to the requesting 


site. 


The message number and subsystem recognition character are 
not included in this message. 


[OO Internal DB2 Information ~~ ail 
This message is issued by the following CSECT(s): DSNTDMUL 


Ege eects End of Internal DB2 Information ee 


System Action: See the Expianation. 


DSNT3311 — DSNT362I 


RREKEEEREREKEKEKEREKREREREEEREREREE 


DSNT3601 


Explanation: This message consists of 70 asterisks and begins 
the display of any database and the display of space names for 
any database. 


Internal DB2 Information J oS “4 
This message is issued by the following CSECT(s): DSNTDMSG 


See End of Internal DB2 information ae 


DSNT3611 *DISPLAY DATABASE SUMMARY* report-type-list 


Explanation: This message is a multiple-tine message that 
labels the requested set of databases, table spaces, and index 
spaces. 


In the message, 'report-type-list' lists all options specified on 
the command delimited by spaces. Possible values are: 


ACTIVE 
GLOBAL 


All allocated databases are listed. 


All requested database information is listed. 
This title is produced if ACTIVE, DISABLED, and 
RESTRICT are omitted. 


LOCKS The connection identifiers and correlation iden- 
tifiers of all applications holding or waiting for 


locks on the specified database are displayed. 


RESTRICT All databases with restricted usage (that is, RO, 


started UT) are listed. 


USE The connection identifiers and correlation iden- 


tifiers of all allocated applications are listed. 


[ Internal DB2 Information ” oe ee | 
This message is issued by the following CSECT(s): DSNTDMSG 


[hea ates End of Interna! DB2 Information et 


DSNT362I DATABASE = data-base-name STATUS = status 


DBD LENGTH = dbd-length 


Explanation: This message signals the beginning of display 
information for a database processed by the DISPLAY DATA- 
BASE command. This message lists the name, status, and DBD 
length of the database. All table space and index space names 
listed in the following DSNT392!, DSNT394I, or DSNT3961 mes- 
sages are contained within this database. 


In the message, 'data-base-name' indicates the database 
name. 


In the message, 'status' is a combination of one or more of the 
following strings delimited by a comma. The maximum length 
of the string is 18 characters. 


COPY An image copy is required for this object. 

DEFER The table space or index space is marked for 
deferred restart due to being explicitly deferred on 
the START command (in which case STOP will also 
be displayed) or due to a problem encountered by 
DB2 during RESTART (in which case STOPE will also 
be displayed). 

INDBT The status of the space is indoubt. 

REST The table space or index space is currently under 
restart processing. 

RO The table space or index space is started for read 


activity only. 
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DSNT3631 — DSNT375I 


RW The table space or index space is started for read © 
and write activity. 

STOP The table space or index space is stopped. 

STOPE DB2 has implicitly stopped the table space or index 
space due to a connect failure. 

STOPN The table space or index space is in the process of 
being stopped. 

STOPP A stop is pending or is in progress for this table 


space or index space. 
UT The table space or index space is started for utility 
processing only. 


UTRO Although the table space or index space is started 
as RW, a utility is in process and only RO access is 
allowed. 

UTRW The table space or index space is started as RW and 
a utility is in process. 

UTUT Although the table space or index space is started 


as RW, a utility is in process and only UT access is 
allowed. 


| ~ Internal DB2 Information ~~ ~~. a 
This message is issued by the following CSECT(s): DSNTDMSG 


(eee End of Internal DB2 Information eae nl 


DSNT3631 PHYSICAL ERROR PAGE RANGE FOR DATA SET 


data-set-name LOW = lowphy, HIGH = hiphy 


Explanation: This message is the response to a -DISPLAY 
DATABASE command when the SPACENAM keyword is speci- 
fied in order to notify the user of any physical I/O errors 
encountered on a data set. 


In the message, 'data-set-name' is the name of the data set 
with errors. The variables 'lowphy' and 'hiphy' identify the 
range of physical pages, within the data set, that were being 
read when the I/O errors occurred. Physical page numbers are 
assigned in relationship to the beginning of the data set in 
which the pages reside. 


This message is always preceded by messages DSNT360! and 
DSNT361!, which identify the name of the database and page set 
that the specified data set supports. 


Page sets (table spaces or index spaces) are made up of sup- 
porting data sets. Physical pages are pages in supporting data 
sets that are numbered from the beginning of the particular 
data set in which they reside. This message refers to physical 
pages in a data set that support (are part of) some page set. 


ie Internal DB2 Information oe el 
This message is issued by the following CSECT(s): DSNTDCST 


———ae End of Internal DB2 Information oe et 


System Action: See the Explanation section for this message. 


DSNT365I NO DATABASES FOUND 


Explanation: This message is produced when a DISPLAY 
DB(name) is entered and no databases were found to satisfy 
the request. 
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+ Internal DB2 Information eee 
This message is issued by the following CSECT(s): DSNTDMSG 


(eee ee End of internal DB2 Information eee ee 


System Action: The process continues normally. 


DSNT366I DATABASE name NOT type 


Explanation: A database listed in the DISPLAY DB(...) is not of 


the correct type. The variables are as follows: 
name The name of the object. 


The type of request specified: 
ACTIVE, RESTRICTED, ACTIVE OR RESTRICTED 


Note that either DSNT301I or DSNT302I is produced if no object 
is found and the keywords ACTIVE and RESTRICT are omitted. 


type 


| =a internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTDMSG 


[ee Sees te End of Internal DB2 Information Bee See) 


System Action: Processing continues normally. 


DSNT3671 NO INFORMATION AVAILABLE 


Explanation: This message is produced when there is no 
LOCK or USE information available. When DISPLAY DB(...) is 
entered, and DB(...) is a list of databases or a list of names, this 
message indicates that no listed database has LOCK or USE 
information available. 


lf DISPLAY DB(...) or DISPLAY DB(...) SPACENAM(*) is entered, 
and DB(...) is a range or subset of databases, or all databases 
('*'), this message indicates that no databases, for which the 
invoker has authority to display, have LOCK or USE information 
available. This message is produced only when the keywords 
USE and LOCKS are specified. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTDMSG 


re End of Internal DB2 Information ae ee 


System Action: The process continues normally. 


DSNT3751 PLAN plan-id1 WITH CORRELATION-ID id1 
CONNECTION-ID id2 LUW-ID id3 IS DEADLOCKED 
WITH PLAN plan-id2 WITH CORRELATION-ID id4 


CONNECTION-ID id5 LUW-ID id6 


Explanation: This message is issued whenever plan 'plan-id1' 
with correlation 'id1', connection 'id2', and LUW 'id3' is 
denied an IRLM lock because of a detected deadlock. Plan 
'plan-id2' identifies one of the members of the deadlock. 


plan-id1, plan-id2 
The names of the executing plans. 


id1 The correlation identifier of the thread associated 
with 'plan-id1'. 

id2 The connection identifier of the thread associated 
with 'plan-id1'. 


id3 The fogical-unit-of-work identifier of the thread asso- 
ciated with 'plan-id1'. An '*' indicates that the 
thread does not have an LUW-ID. If not an '*', the 
value is a logical-unit-of-work-id that is assigned to 
the thread followed by an '=' sign and a token 
value which may be used in place of logicat-unit-of- 
work-id in any DB2 command that accepts logical- 
unit-of-work-id as input. 


id4 The correlation identifier of the thread associated 
with 'plan-id2'. 

id5 The connection identifier of the thread associated 
with 'plan-id2'. 

id6 The logical-unit-of-work identifier of the thread asso- 


ciated with 'plan-id2'. An '*' indicates that the 
thread does not have a LUW-ID. If the LUW-ID is not 
an '*', the value is a logical-unit-of-work-id that is 
assigned to the thread followed by an "=" sign and 
a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts 
logical-unit-of-work-id as input. 


The SQLCA corresponding to correlation id 'id1', connection id 
‘id2', and LUW-ID 'id3' contains an SQL return code of -904, 
-911, -913, or -923 and the name of the resource involved in the 
deadlock. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTLSUS 


oe ar End of Internal DB2 Information eee 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 17. 


DSNT376l PLAN plan-id1 WITH CORRELATION-ID id1 
CONNECTION-ID id2 LUW-ID id3 IS TIMED OUT 
DUE TO ALOCK HELD BY PLAN plan-id2 WITH 
CORRELATION-ID id4 CONNECTION-ID id5 LUW-ID 


id6 


Explanation: This message is issued whenever plan 'plan-id1' 
with correlation 'id1', connection ‘id2', and LUW '‘id3' is 
denied a lock by IRLM, because the amount of time to wait for a 
locked resource was exceeded. Plan 'plan-id2' identifies one 
of the plans holding a lock on the desired resource. 


plan-id1, plan-id2 
The names of the executing plans. 


id1 The correlation identifier of the thread associated 
with 'plan-id1'. 

id2 The connection identifier of the thread associated 
with 'plan-id1'. 

id3 The logical-unit-of-work identifier of the thread asso- 


ciated with ‘plan-id1'. An '*' indicates that the 
thread does not have a LUW-ID. If the LUW-ID is not 
an '*', the value is a logical-unit-of-work-id that is 
assigned to the thread followed by an "=" sign and 
a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts 
logical-unit-of-work-id as input. 


DSNT376I — DSNT376l 


id4 The correlation identifier of the thread associated 
with 'plan-id2'. 

id5 The connection identifier of the thread associated 
with '‘plan-id2'. 

id6 The logical-unit-of-work identifier of the thread asso- 


ciated with 'plan-id2'. An '*' indicates that the 
thread does not have a LUW-ID. If the LUW-ID is not 
an '*', the value is a fogical-unit-of-work-id that is 
assigned to the thread followed by an "=" sign and 
a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts 
logical-unit-of-work-id as input. 


The SQLCA corresponding to correlation-id 'id1', connection-id 
‘id2', and LUW-ID 'id3' contains an SQL return code of -904 or 
-923 and the name of the resource involved in the timeout. 


Several different system plans can appear in the 'plan-id1' and 
‘plan-id2' sections of this message. These system plans are 
not documented in SYSIBM.SYSPLAN. If you receive a system 
plan in this message, you are in contention with another user. 
Message DSNT500! accompanies this message and identifies 
that resource. If you need additional information, refer to the 
SQLCA and any additional bind messages. The system plans 
are: 


ACT 

BCT 
BINDCT 
STARTCT 
DSNUTIL. 


rie internal DB2 Information | 


This message is issued by the following CSECT(s): DSNTLSUS 


eee End of Internal DB2 Information ee el 


Operator Response: Notify the system programmer. 


System Programmer Response: This condition might be 
caused by an undetected deadlock, for example, an agent 
holding a lock on the resource for a period of time that exceeds 
either the specified time or the IRLM default wait time. 


If the time limit is too small, you can increase the limit by speci- 
fying a new IRLM locked resource wait time timit. To do this, 
you can either use the parameter in the DSN6SPRM assembler 
macro in the DSNTIJUZ job stream or update the ' wait time' 
field of the DB2 installation IMS Resource Lock Manager panel, 
'IRLMRWT'. You must also specify all other parameters con- 
tained in this version of the CSECT. Then do one of the fol- 
lowing: 


¢ Resubmit installation job DSNTIJUZ with the link-edit SYSIN 
file ‘'NAME' parameter that matches the -START DB2 
'PARM=' parameter. 

¢ Reassemble DSN6SPRM and re-link-edit DSNZPARM by 
resubmitting installation job DSNTIJUZ. The link-edit SYSIN 
file 'NAME' parameter must match the -START DB2 
‘PARM= ' parameter. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9, 17. 
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DSNT377I — DSNT382l 


DSNT3771 PLAN plan-id1 WITH CORRELATION-ID id1 
CONNECTION-ID id2 LUW-ID id3 IS IN CONFLICT 


WITH AN INDOUBT THREAD 


Explanation: This message is issued by the service controller 
subcomponent. A plan cannot gain an IRLM lock because a 
required resource is currently undergoing recovery. The 
message identifies the plan in this way: 


plan-idi The name of the executing plan. 

id1 The correlation identifier (ID) of the thread associ- 
ated with plan 'plan-id1'. 

id2 The connection-ID of plan 'plan-id1'. 

id3 The logical-unit-of-work ('LUW-ID') of 'plan-id1'. 


An '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a 
logical-unit-of-work id that is assigned to the thread 
followed by an "=" sign and a token value which 
may be used in place of logical-unit-of-work-id in any 
DB2 command that accepts logical-unit-of-work-id as 
input. 


The SQLCA corresponding to correlation-ID 'id1', 
connection-ID 'id2', and LUW-ID 'id3' contains an SQL return 
code -904, -911, -913, or -923 and the name of the resource cur- 
rently being recovered by DB2. 


is Internal DB2 Information ae 
This message is issued by the following CSECT(s): DSNTLSUS 


lee eee End of Internal DB2 Information Ee ens 44 


System Action: Processing continues. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 4. 


DSNT3791 CANNOT IDENTIFY TO IRLM. INVALID SSNAME 


Explanation: Either an attempt was made to identify the IRLM 
with a subsystem name not recognized by MVS, or the IRLM is 
not currently active. 


| : Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTLIDE 


ates End of Internal DB2 Information _ 


System Action: DB2 abends with a reason code of X'04E'. 
Operator Response: Notify system programmer. 


System Programmer Response: This is probably a user error. 
Change the IRLMSID parameter in the DB2 DSN6SPRM initial- 
ization macro to match the MVS subsystem table. 


DSNT3801 CANNOT IDENTIFY TO IRLM, SSNAME ALREADY 


IN USE 


Explanation: Either DB2 previously terminated and did not suc- 
cessfully sign off from IRLM, or another subsystem is identified 
to IRLM with this installation-defined SSNAME. This message 
accompanies abend reason code X'00E30071'. 
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| Internal DB2 information | 
This message is issued by the following CSECT(s): DSNTLIDE 


[eas End of Internal DB2 Information ee 


System Action: DB2 is abended with an abend code of X'04E'. 
Operator Response: Notify ihe system programmer. 


System Programmer Response: Either manually stop iRLM, or 
change the installation-defined SSNAME. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9, 17. 


DSNT381I IRLM QUIT REQUEST FAILED, RC = xx, 


SC = yy 


Explanation: During the QUIT (or signoff) request to the IMS/VS 
Resource Lock Manager, a return code and subcode were 
returned indicating an unsuccessful completion of the request. 
Refer to “Section 5. IRLM Messages and Codes” on page 5-1, 
for IRLM return codes and subcode meanings. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTLQUI 


—— End of internal DB2 Information | 


System Action: This message indicates that the DB2 sub- 
system shutdown could not be completed normally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine the cause of the 
failure from the return code and subcode, and correct the error. 
Refer to “Section 5. IRLM Messages and Codes” on page 5-1, 
for IRLM return codes and subcode meanings. DB2 has termi- 
nated but has not signed off from IRLM. It will be necessary to 
issue the 'F irlmproc, ABDUMP' command to stop the IRLM. 
This must be done before issuing another -START DB2 
command. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9, 17. 


DSNT382i IRLM AUTO-START FAILED 


Explanation: During the IDENTIFY to IRLM, the AUTO-START of 
IRLM using SVC 34 failed. This message accompanies abend 
code X'00E30080'. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTLIDE 


[ End of Internai DB2 Information _ 


System Action: DB2 is terminated with an abend code of 
X'04E'. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine the cause of failure 
from the SVC 34 return code preserved in register 2. 


va 


DSNT3831 csect-name IRLM AUTO-STOP FAILED 


Explanation: During a sign off from IRLM caused by either DB2 
normal shutdown (CSECT DSNTLQU)}) or DB2 subsystem termi- 

nation (CSECT DSNTLCLE), an AUTO-STOP of IRLM using SVC 

34 failed. If this occurred during normal sign off, this message 

accompanies abend reason code X'00E30075'. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNTLQUI, 
DSNTLCLE 


We ee End of Internal DB2 Information Soh ai ann 


System Action: DB2 abends. 
Operator Response: Notify the system programmer. 
System Programmer Response: Manually stop IRLM. 


Problem Determination: Determine the cause of failure from 
the SVC return code preserved in register 2. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 9. 


DSNT384I IRLM AUTO-START WAIT TIME EXCEEDED 


Explanation: An attempt was made to automatically start IRLM. 
However, the wait time specified was exceeded. 


[ internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNTLIDE 


ee Ae ee End of Internal DB2 Information ees 


System Action: DB2 is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Either manually start IRLM or 
modify the installation-defined auto-start wait time. Restart 
DB2. 


Probiem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9. 


Check the IRLMID given in the IRLM procedure against the 
IRLMSID in macro DSN6SPRM which was in the DSNZPARM 
used at startup. 


DSNT3901 * DISPLAY OF DATABASE name action* 


Explanation: This message indicates the end of a set of 
DSNT3911 and DSNT3921 messages, a set of DSNT3931 and 
DSNT394I messages, or a set of DSNT3951 and DSNT396! mes- 
sages. 


in this message: 
¢ The 'name' is the name of the database. 
¢ The ‘action' is one of the following: 


CONTINUES 
The remaining table space and index space 
names within this database are continued to a 
new display. 


| 


DSNT383I — DSNT392I 


TERMINATED 
The remaining table space and index space 
names within this database are terminated. 


ENDS The display for this database is complete. 


| Internal DB2 Information ~ 


| This message is issued by the following CSECT(s): 


DSNTDMUL DSNTDMSG 


| [End of internal DB2 Information ____—_ 


DSNT3911 NAME TYPE STATUS PHYERRLOW PHYERRHI 


CATALOG PIECE 


Explanation: This message indicates the beginning of a set of © 
messages used to display information as a result of a DISPLAY 
DATABASE command when the keywords LOCK and USE are 
omitted. (The message appears in one continuous line across 
the screen, not as shown above.) This message forms the 
headings of the display. The message is always followed by 
multiple DSNT392I messages containing the column data. Refer 
to message DSNT392I for a description of the data these 
headings identify. 


>. Internal DB2 Information aa) 
This message is issued by the following CSECT(s): DSNTDMUL 


eee ees End of Internal DB2 Information Steet ot 


DSNT392I space type par status lo-page hi-page cat- 


name piece 


Explanation: This message contains the display information as 
a result of a DISPLAY DATABASE command when the keywords 
LOCK and USE are omitted. This message contains the column 
data describing the status of a table space or index space in the 
database listed in the preceding DSNT362I message. This 
message is always preceded by its column headings message 
DSNT391!. The message number for this message will not be 
displayed. However, the messages DSNT391I, DSNT3921, and 
DSNT390! are always produced with a multiple line WTO and 
will never be interrupted. 


In this message: 


*° The 'space' is the table space name or index space name, 
or table OBID. 

¢ The 'type' equals 'TS' for a table space or 'IX' for an 
index space, or 'TB' for a table. 

¢ This 'part' is the partition number. It is blank for a simple 
table space or simple index space. 

e The 'status' is one or more of the following, delimited by 
commas. The maximum length is 18 characters: 


CHKP The table space is in CHECK PENDING state. 

COPY An image copy is required for this object. 

DEFER The table space or index space is marked for 
deferred restart due to being explicitly deferred 
on the START command (in which case STOP 
will also be displayed) or due to a problem 
encountered by DB2 during RESTART (in which 
case STOPE will also be displayed). 

INDBT The status of the space is indoubt. 

RECP The table space or index space is in RECOVER 
PENDING state. 

REST The table space or index space is currently 


under restart processing. 
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DSNT393I — DSNT394I 


RO The table space or index space is started for 
read activity only. 


RW The table space or index space is started for 
read and write activity. 

STOP The table space or index space is stopped. 

STOPE DB2 has implicitly stopped the table space or 
index space due to a connect failure. 

STOPP A stop is pending or is in progress for this table 


space or index space. 
UT The table space or index space is started for 
utility processing only. 


UTRO Although the table space or index space is 
started as RW, a utility is in process and only RO 
access is allowed. 

UTRW The table space or index space is started as RW 
and a utility is in process. 

UTUT Although the table space or index space is 


started as RW, a utility is in process and only UT 
access is allowed. 

e The 'lo-page' is a hexadecimal number that identifies the 
lowest page number containing an I/O error when a data 
set supporting the specified table space or index space has 
i/O physical errors. This column is blank if there are no 
physical errors. 

¢ The 'hi-page' is a hexadecimal number that identifies the 
highest page number containing an 1/O error when a data 
set supporting the specified table space or index space has 
1/0 physical errors. This column is blank if there are no 
physical errors. 

¢ The 'cat-name' identifies the catalog owning the data set 
with the I/O errors when a data set supporting the specified 
table space or index space has I/O physical errors. This 
column is blank if there are no physical errors. 

* The 'piece' is an integer number that identifies the piece 
within the table space or index space containing an error 
when a data set supporting the specified table space or 
index space has physical I/O errors. This column is blank if 
there are no physical errors. 


The piece number can be used to construct the name of the 
data set supporting the space containing the physical error 
as follows: 


cat-name.DSNDBC.database- 
name.space-name.l0001.Axxxx 


The value 'xxxx' is the piece number plus one and 
‘database-name' is the name displayed in the preceding 
DSNT362I message. Note that if the table space or index 
space is partitioned, the partition number should equal the 
piece number plus one. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTDMUL 


ae End of Internal DB2 Information Be ee Tat 


NAME TYPE PART STATUS 
CORRID USERID 


DSNT393I CONNID 


Explanation: This message indicates the beginning of a set of 
messages used to display information as a result of a DISPLAY 
DATABASE command when the keyword USE is specified. This 
message contains the headings of the display. (The message 
appears in one continuous line across the screen, not as shown 
above.) The message is always followed by multiple DSNT3941 
messages containing the column data. Refer to message 
DSNT394I for a description of the data these headings identify. 
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| Internal DB2 Information =F] 
This message is issued by the following CSECT(s): DSNTDMUL 


Ls End of internal DB2 Information 


DSNT394I space type part status conn-id corr-id user-id 


Explanation: This message contains the display information 
resulting from a DISPLAY DATABASE command when the 
keyword USE is specified. This message contains the column 
data describing the status of a table space or index space in the 
database listed in the preceding DSNT362! message. This 
message is always preceded by its column headings message 
DSNT393/. The message number for this message will not be 
displayed. However, the messages DSNT3931, DSNT394I, and 
DSNT390! are always produced with a multiple line WTO and 
will never be interrupted. 


In this message: 


e The 'space' is the table space name or index space name, 
or table OBID. 


° The 'type' equals 'TS' for a table space or 'IX' for an 
index space, or 'TB' for a table. 


¢ The 'part' is the partition number. {tis blank for a simple 
table space or simple index space. 


¢ The 'status' is one or more of the following, delimited by 
commas. The maximum length is 18 characters: 


CHKP The table space is in CHECK PENDING state. 

COPY An image copy is required for this object. 

DEFER The table space or index space is marked for 
deferred restart due to being explicitly deferred 
on the START command (in which case STOP 
will also be displayed) or due to a problem 
encountered by DB2 during RESTART (in which 
case STOPE will also be displayed). 

INDBT The status of the space is indoubt. 

RECP The tabie space or index space is in RECOVER 
PENDING state. 

REST The table space or index space is currently 
under restart processing. 

RO The table space or index space is started for 
read activity only. 

RW The table space or index space is started for 
read and write activity. 

STOP The table space or index space is stopped. 

STOPE DB2 has implicitly stopped the table space or 
index space due to a connect failure. 

STOPP A stop is pending or is in progress for this table 
space or index space. 

UT The table space or index space is started for 
utility processing only. 

UTRO Although the table space or index space is 
started as RW, a utility is in process and only RO 
access is allowed. 

UTRW The table space or index space is started as RW 
and a utility is in process. 

UTUT Although the table space or index space is 


started as RW, a utility is in process and only UT 
access is allowed. 


® The ‘conn-id' is a connection identifier for the thread. It is 
one of the following: 


— BATCH if the command is from a batch region. 

- TSO if the command is from a TSO terminal. 

— 'IMS identifier' if the command is from an IMS/VS ter- 
minal. 

— ‘CICS identifier’ if the command is from a CICS ter- 
minal. 

— ‘SRC' if the command is from the console. 


¢ '‘corr-id' is a correlation identifier of the thread associated 
with the space name. It is one of the following: 


— 'job name' if the command is from a batch region. 

— 'TSO logon identifier' if the command is from a TSO 
terminal. 

— PST#.PSBNAME if the command is from an IMS/VS ter- 
minal. 

—- ‘entry ID.thread number.tran id' if the command is from 
a CICS terminal. 

~ 'SRC' if the command is from the console. 


¢ The ‘user-id' is either: 


— ‘TSO logon identifier' if the command is from a TSO 
terminal. 

— ‘sign-on id' or the LTERM if the command is from an 
IMS/VS message-driven region. 

— AXBUSER if the command is from an IMS/VS message- 
driven region and RACF is used. 

— 'PSB name' if the command is from an IMS/VS non- 
message-driven region and RACF is not used. 

— ‘user-id', 'termid', 'Tran id' or other as specified in 
the resource control table (RCT) if the command is from 
CICS. 


i. Internal DB2 Information ie aie | 
This message is issued by the following CSECT(s): DSNTDMUL 


Dees End of Internal DB2 Information ar 


DSNT3951 NAME TYPE PART STATUS 


CORRID LOCKINFO 


CONNID 


Explanation: This message indicates the beginning of a set of 
messages uSed to display information as a result of a DISPLAY 
DATABASE command when the keyword LOCK is specified. 
This message forms the headings of the display. (The message 
appears in one continuous line across the screen, not as shown 
above.) The message is always followed by multiple DSNT396I 
messages containing the column data. Refer to message 
DSNT396I for a description of the data these headings identify. 


a Internal DB2 Information ~~ —— 
This message is issued by the following CSECT(s): DSNTDMUL 


———— End of Internal DB2 Information ee ee 


DSNT396I space type part status conn-id corr-id lock 


Explanation: This message contains the display information 
that results from a DISPLAY DATABASE command when the 
keyword LOCK is specified. This message contains the column 
data describing the status of a table space or index space in the 
database listed in the preceding DSNT3621 message. This 
message is always preceded by its column headings message 
DSNT395l. The message number for this message will not be 
displayed. However, the messages DSNT395I, DSNT396I, and 


DSNT3951 — DSNT396I 


DSNT390! are always produced with a multiple line WTO and 
will never be interrupted. 


In this message: 


* The 'space' is the table space name, index space name, or 
table OBID. 


° The 'type' equals 'TS' for a table space or 'IX' for an 
index space, or 'TB' for a table. 


¢ The 'part' is the partition number. It is blank for a simple 
table space or simple index space. 


¢ The 'status' is one or more of the following, delimited by 
commas. The maximum length is 18 characters: 


CHKP The table space is in CHECK PENDING state. 

COPY An image copy is required for this object. 

DEFER The table space or index space is marked for 
deferred restart due to being explicitly deferred 
on the START command (in which case STOP 
will also be displayed) or due to a problem 
encountered by DB2 during RESTART (in which 
case STOPE will also be displayed). 

INDBT The status of the space is indoubt. 

RECP The table space or index space is in RECOVER 
PENDING state. 

REST The table space or index space is currently 


under restart processing. 
RO ' The table space or index space is started for 
read activity only. 


RW The table space or index space is started for 
read and write activity. 

STOP The table space or index space is stopped. 

STOPE DB2 has implicitly stopped the table space or 
index space due to a connect failure. 

STOPP A stop is pending or is in progress for this table 


space or index space. 
UT The table space or index space is started for 
utility processing only. 


UTRO Although the table space or index space is 
started as RW, a utility is in process and only RO 
access is allowed. 

UTRW The table space or index space is started as RW 
and a utility is in process. 

UTUT Although the table space or index space is 


started as RW, a utility is in process and only UT 
access is allowed. 


Ifthe 'type' is 'TB', the 'status' field is blank. 


¢ The 'conn-id' is a connection identifier for the thread. Itis 
one of the following: 


— BATCH if the command is from a batch region. 

— TSO if the command is from a TSO terminal. 

— 'IMS identifier' if the command is from an IMS/VS ter- 
minal. 

— ‘CICS identifier’ if the command is from a CICS ter- 
minal. 

— 'SRC' if the command is from the console. 


¢ The 'corr-id' is a correlation identifier of the thread associ- 
ated with the space name. It is one of the following: 


— 'job-name' if the command is from a batch region. 

— 'TSO logon identifier' if the command is from a TSO 
terminal. 

— PST#.PSBNAME if the command is from an IMS/VS ter- 
minal. 

— ‘entry 1D.thread number.tran id' if the command is from 
a CICS terminal. 

— 'SRC' if the command is from the console. 
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DSNT3971 — DSNT408I 


* The 'lock' describes the type and duration of locks used by 
corresponding agents identified by their connection and 
correlation IDs. Multiple locks held by an agent are listed 
on multiple fines of the report followed by any locks the 
agent is currently awaiting. The ‘lock' is composed of a 
‘lock qualifier' and, enclosed in parenthesis, a ‘lock 
identifier', followed by a 'lock unit', and a ‘lock 
descriptor’ delimited by commas. 


~ The ‘lock qualifier' is a value of: 

— H to indicate that the lock is held by the agent, or 

— Wo indicate that the agent is awaiting the lock. 

— The ‘lock identifier' describes the type of lock as 
follows: 

— 1S denotes a table space lock with read intentions 
(Shared). 

— IX denotes a table space or lock with update 
intentions (Exclusive). 

— SIX denotes a table space lock with a protocol that 
does not lock a page while reading (Shared), but 
will lock the page with update intention (Exclusive) 
while updating. 

— S denotes a Jock with read intention (Shared). 

— X denotes an exclusive lock. 

— The ‘lock unit' describes the unit of locking as follows: 

— Sindicates a table space or index space lock. 

— P indicates a page lock. 

— T indicates a table lock. 

— Ifthe ‘lock qualifier' is H, the. 'lock descriptor‘ 
describes the duration of the lock. This duration indi- 
cates how long ai// acquired locks are held by an agent. 


Note: Since all locks for a user are released at the 
same time, the lock duration information is displayed 
only with those locks with a ‘lock qualifier’ of H. 

— A indicates that the lock is freed at deallocation. 
~ C indicates that the lock is freed at commit. 

— M indicates that the lock is freed by the system. 


Otherwise, the ‘lock descriptor' is a three digit number 
indicating the agent’s position in the lock waiting 
queue. When this lock is acquired, its duration is the 
same as all locks held by the user. 


There are no explicit index space locks. However, all index 
spaces on tables are implicitly locked at the same level as the 
table spaces containing those tables. 


CT Internal DB2 information ; 
This message is issued by the following CSECT(s): DSNTDMUL 


(eee End of Internal DB2 Information eee 


DSNT3971 


Explanation: This message indicates the beginning of a mul- 
tiple line display generated as a result of a DISPLAY DATA- 
BASE command. This message is followed by DSNT391I, 
DSNT393!, or DSNT3951. 


[ Internal DB2 Information | 
This message is issued by CSECT(s): DSNTDMUL 


Pee es End of Internal DB2 Information a: 
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DSNT3981 


Explanation: This message appears within a multiple line WTO 
message set and precedes DSNT391!, DSNT393!, and DSNT395I. 
it is used to underscore the column headings. 


rT Internal DB2 Information ee 
This message is issued by CSECT(s): DSNTDMUL 


———— End of Internal DB2 Information ee 


DSNT3991 INVALID space-name 


Explanation: The space-name specified in the SPACENAM 
keyword on the -DISPLAY DATABASE command does not exist. 
The name of the table space or index space is 'space-name'. 
The request is rejected. 


| ame = Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTDMUL 


a es End of Internal DB2 Information _ 


DSNT4001 SQLCODE = 0, SUCCESSFUL 


Explanation: The SQLCODE was 0, indicating successful exe- 
cution of the function. SQLWARN indicators may note some 
warnings. 


a ~~ Internal DB2 Information =, | 
This message is issued by the following CSECT(s): DSNTIAR 


[| End of Internal DB2 Information 


DSNT404I SQLCODE = xxx, explanation 


Explanation: This message contains a SQLCODE and a brief 
explanation, with text inserted from the SQLERRM field. The 
SQLCODE is positive, indicating a warning condition. For more 
information about this SQLCODE, see “Section 2. SQL Return 
Codes” on page 2-1. 


| ~~ Internal DB2 Information sate | 
This message is issued by the following CSECT(s): DSNTIAR 


ae End of Internal DB2 Information eee ee) 


System Programmer Response: Determine the cause for the 
SQL warning code, and correct the situation if needed. Rerun 
the application program or SQL statement. 


DSNT408I SQLCODE = -xxx, explanation 


Explanation: This message contains a SQLCODE and a brief 
explanation, with text inserted from the SQLERRM field. The 
SQLCODE is negative, indicating that an error has occurred. 
For more information about this SQLCODE, see “Section 2. SQL 
Return Codes” on page 2-1. 


7 ~— Internal DB2 Information ~— aa 
This message is issued by the following CSECT(s): DSNTIAR 


| End of internal DB2 Information 


System Programmer Response: Determine the cause for the 
SQL error by using information about that specific SQLCODE. 
Correct the error if desired. Rerun the application program or 
SQL statement. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 13, 16. 


DSNT411i SQLCAID = xxxx, SQLCA IDENTIFIER 


Explanation: The SQLCA ID field (SQLCAID) is not the 
expected value, C'SQLCA'. 


Po eee internal DB2 Information aa | 
This message is issued by the following CSECT(s): DSNTIAR 


[ee ee End of Internal DB2 Information feet tll 


System Programmer Response: The SQLCA area is invalid. 
This type of error is usually the result of one of the following: 


* Calling the DSNTIAR formatting routine before an SQL call 
initializes the area 


* Overlaying the SQLCA area 
¢ Passing the wrong address to the DSNTIAR routine. 


Correct the error, and rerun the application program. 


DSNT4121 SQLCABC = xxxx, SQLCA BYTE COUNT 


Explanation: The size of the SQLCA is not the expected value 
(136 bytes). 


[ = Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTIAR 


a es End of Internal DB2 Information a tl 


System Programmer Response: The SQLCA area is invalid. 
Correct the error. It is probably an overlay or an incorrect 
SQLCA address. Rerun the application program. 


DSNT4131 SQLCODE = xxxx, INVALID SQLCODE 
Explanation: The SQLCODE is not a valid value. 


oS internal DB2 Information pee ty 
This message is issued by the following CSECT(s): DSNTIAR 


eee End of Internal DB2 Information | 


System Programmer Response: Either the SQLCA area is 
invalid or the maintenance was not coordinated correctly. Asa 


DSNT4111 — DSNT415I 


result, the SQLCODE was added to the DB2 subsystem but not 
to the formatting routine. 


An invatid SQLCA area is usually the result of one of the fol- 
lowing: 


¢ Calling the DSNTIAR formatting routine before an SQL call 
initializes the area 


¢ Overlaying the SQLCA area 
¢ Passing the wrong address to the DSNTIAR routine. 


If the maintenance was not coordinated correctly, the DSNTIAR 
and DSNTIAM CSECTs were probably not replaced in the code 
that is now running. Link-edit the load module, and replace 
DSNTIAR and DSNTIAM. Correct the error, and rerun the appili- 
cation program. 


DSNT4141 SQLERRM = xxxx, SQLCA MESSAGE INSERTION 


TEXT 


Explanation: This message results from an SQLCODE which is 
not recognized by DSNTIAR. SQLERRM contains error 
message text. 


— Internal DB2 Information OY 
This message is issued by the following CSECT(s): DSNTIAR 


eee End of Internal DB2 Information sito wel 


System Programmer Response: Either the SQLCA area is 
invalid or the maintenance was not coordinated correctly. As a 
result, the SQLCODE was added to the DB2 subsystem but not 
to the formatting routine. 


An invalid SQLCA area is usually the result of one of the fol- 
lowing: 
* Calling the DSNTIAR formatting routine before an SQL call 
initializes the area 
e Overiaying the SQLCA area 
¢ Passing the wrong address to the DSNTIAR routine. 


If the maintenance was not coordinated correctly, the DSNTIAR 
and DSNTIAM CSECTs were probably not replaced in the code 
that is now running. Link-edit the load module, and replace 
DSNTIAR and DSNTIAM. Correct the error, and rerun the appli- 
cation program. 


DSNT4151 SQLERRP = xxxx, SQL PROCEDURE DETECTING 


ERROR 


Explanation: The name of the procedure detecting the error is 
provided in the SQLERRP. 


—— Internal DB2 Information ._ . 
This message is issued by the following CSECT(s): DSNTIAR 


ere End of Internal DB2 Information ee | 


System Programmer Response: (The SQL procedure detecting 
the error may be of help in diagnosing an error or warning.) 
Correct the error if there is one noted in other messages. 
Rerun the program or SQL statement. 
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DSNT416I — DSNT435i 


DSNT416I SQLERRD = xx,xx,xx,xx,xx,xx SQL DIAGNOSTIC 


INFORMATION 


Explanation: At least one of the six diagnostic fields is not the 
expected value. The expected values are: 


¢ 00, 00, 00, 00, 00, 00 or 
¢ 00, 00, 00, -1, 00, 00 


The SQL diagnostic information for each of the six values is as 
follows: 


1 DB2 unique internal relational data system code 

2 DB2 internal data manager error code 

3 Number of rows inserted, updated, or deleted following an 
INSERT, UPDATE, or DELETE statement 

4 Reserved 

5 Position or column of a syntax error for PREPARE or 
EXECUTE IMMEDIATE 

6 DB2 internal buffer manager error code 


| Internal DB2 information | 
This message is issued by the following CSECT(s): DSNTIAR 


Ls End of internal DB2 Information _________| 


System Programmer Response: Refer to Appendixes of SQL 
Reference for further information on the contents of the 
SQLERRD fields. The SQL diagnostic information may be of 
help in diagnosing an error or in indicating the results of suc- 
cessful execution. If this error or warning should not occur, 
correct the error. Rerun the program or SQL statement. 


DSNT417I SQLWARN = x x x x x x x x, SQL WARNINGS 


Explanation: At least one of the eight warning values is not the 
expected value, that is, a blank. The SQL warning information 
for each of the eight values is as follows: 


0 Any other warning code is set. 

1 String truncates. 

2 Null value(s) are eliminated. 

3 Number of host variables provided does not equal 


degree of the table. 

There is no WHERE clause on UPDATE or DELETE. 
Is not a DB2 SQL statement 

Reserved. 

Reserved. 


NO 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTIAR 


eee End of Internal DB2 Information res 


System Programmer Response: The SQL warning information 
might be of help in diagnosing an error or in indicating the 
results of successful execution. If this warning should not 
occur, correct the error. Rerun the program or SQL statement. 


DSNT4181 SQLEXT = xxxx, SQLCA EXTENSION FIELD 


Explanation: The SQLEXT field in the SQLCA is not the 
expected value (zeros). 
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SS Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNTIAR 


Ls End of Internal DB2 Information ____——_ 


System Programmer Response: The SQLCA area is invalid. 
This type of error is usually the result of one of the following: 


¢ Calling the DSNTIAR formatting routine before an SQL call 
initializes the area 


¢ Overlaying the SQLCA area 
e Passing the wrong address to the DSNTIAR routine. 


Correct the error, and rerun the application program. 


DSNT429I The sum of MAX USERS and MAX REMOTE must 


be less than or equal to 220 


Explanation: The total number of threads determined by MAX 
USERS and MAX REMOTE fields is too large. 


Internal DB2 Information ras “i 
This message is issued by the following PANEL: DSNTIPE 


bees | End of Internal DB2 Information tone al 


System Action: The panel is redisplayed and the cursor is 
placed on the field in error. 


User Response: Reduce either the MAX USERS field or the 
MAX REMOTE field or both. 


DSNT4351 TOO MANY CONCURRENTLY ALLOCATED DATA 


SETS, opnds 


Explanation: The number calculated, 'opnds’, for the number 

of concurrent databases, tables per database, and table spaces 
per data base, is too large. The maximum number of data sets 

that may be allocated to an MVS address space is 3273. 


The number of concurrently allocated data sets is calculated 
using the formula: 


OPNDS = (NUMCONDB x NUMTABLE x NUMINDEX) + 
(NUMCONDB x NUMTABSP), 


Where Represents 

NUMCONDB The maximum number of concurrently 
active databases 

NUMTABLE The estimated average number of tables 
per database 

NUMINDEX The estimated average number of indexes 
per table (set to 1) 

NUMTABSP The estimated average number of tables 


spaces per database. 


The number 1 is an estimate of the number of indexes per table. 


| aaa Internal DB2 Information SS et 


This message is issued by the following installation CLIST(s): 
DSNTINST 


| End of internal DB2 Information ______—_— 


Severity: 8 (error) 


System Action: The CLIST will continue checking, but no output 
jobs will be produced. | 


User Response: Check the numbers you entered for numbers 
of concurrent databases, tables per database, and table spaces 
per data base. These numbers must be reduced. 


Problem Determination: If you suspect an error in the process, 
set CONTROL(CONLIST) and invoke the CLIST in the batch, so 
that the tracing can be sent with the error documentation. 


DOSNT4361 REGION SIZE MAY BE TOO LARGE 


Explanation: The numbers you specified produced a region 
size estimate of more than 5000K. This region size estimate 
does not include the storage required for SWA because it is 
assumed that SWA has been placed above the line. If a larger 
private area is permitted, you should increase the region size 
on the DB2 start procedures. The region size calculation is 
shown in the DSNT485i through DSNT4871 messages and is dis- 
cussed in Section 2 (Volume 1) of Administration Guide. 


[ a ~~ Internal DB2 Information ~_ 


This message is issued by the following installation CLIST(s): | 
DSNTINST 


fae tae End of Internal DB2 Information ee ee 


Severity: 4 (warning) 
System Action: The CLIST will continue. 


User Response: Check the values entered for numbers of con- 
current users and databases, buffers, and plan sizes. Check 
the available private region size. If this region size is not per- 
mitted, these numbers need to be reduced. If the size is per- 
mitted, this warning may be ignored. 


Problem Determination: {if you suspect an error in the process, 
set CONTROL(CONLIST) and invoke the CLIST. This produces 
tracing for error documentation. 





DSNT4371 REGION SIZE IS TOO LARGE 


Explanation: The numbers you specified produced a region 
size estimate of more than 8000K. This estimate does not 
include the storage required for SWA, because it is assumed 
that you placed SWA above the 16M line. The region size cal- 
culation is discussed in Section 2 (Volume 1) of Administration 
Guide. 


3 Internal DB2 Information 


This message is issued by the following installation CLIST(s): 
DSNTINST 


a ey End of Internal DB2 Information | | 


Severity: 8 (error) | 


System Action: The CLIST wii! continue, but will not produce 
edited jobs. 


User Response: Check the numbers entered for numbers of 
concurrent users and databases, buffers, and plan sizes. One 
or more of these numbers needs to be reduced. 


Problem Determination: If you suspect an error in the process, 
set CONTROL(CONLIST) and invoke the CLIST. This produces 
tracing for error documentation. 


DSNT436I — DSNT439I 


DSNT438i WARNING, IRLM LOCK MAXIMUM SPACE = 


irtmreg K, AVAILABLE SPACE = irlmav K 


Explanation: You specified a maximum number of locks per 
user that could use a total space larger than that available to 
the IRLM, causing it to abend. It is not likely that all threads will 
have the maximum number of locks, but if the maximum 
exceeds the amount of space by a significant factor, the possi- 
bility of abends in the IRLM is increased. 


If the CROSS MEMORY value from the DSNTIPJ install panel is 
YES, the private region size is the space available for the IRLM. 
The available space is estimated as 60000K since extended 
private address space is used. If the CROSS MEMORY value is 
NO, then the MAXIMUM ECSA value space is available for the 
IRLM. The maximum space used is estimated as the MAX 
USERS value from the DSNTIPE panel times the number of 
LOCKS PER USER value on the DSNTIPJ panel times 250 bytes 
per lock. 


| oo? oe Internal DB2 Information 7 = 


This message is issued by the following installation CLIST(s): 
DSNTINST 


eee End of Internal DB2 Information eee 


Severity: 4 (warning) 
System Action: The CLIST will continue. 
User Response: Choose one of the following responses: 


¢ Ensure that you can run with the overcommitment of lock 
address space, or 

e Lower the value of the MAX USERS or LOCKS PER USER 
field. 


DSNT4391 IRLM NO LOCK ESCALATION OR NO USER 


MAXIMUM 
Explanation: You specified the number 0 for: 


¢ The number of table or table space locks that wil! cause 
lock escalation, or 
¢ The number of locks that will terminate a DB2 user. 


A lock escalation value of 0 turns off lock escalation and means 
that DB2 cannot use this means of conserving lock space. A 
user maximum of 0 means that the calculation noted in the 
DSNT438 message cannot be performed to see if the IRLM has 
sufficient address space for all users, since there is no 
maximum per user. 


| — internal DB2 Information Peas 


This message is issued by the following installation CLIST(s): 
DSNTINST 


ee: End of Internal DB2 Information eee 


Severity: 4 (warning) 


System Action: The CLIST will continue. This is only a 
warning. 


User Response: Turn off lock escalation and/or user lock lim- 
iting. 
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DSNT450!1 — DSNT455I 


DSNT450i type ENTRY MUST BE EXACTLY TWO CHARAC- 


TERS 


Explanation: These entries are used to complete 
SYS1.PARMLIB member names and must be exactly two char- 
acters. The type is: 


APF AUTH For the APF authorized library list IEAAPFxx 

LINK LIST For the link list library concatenation 
LNKLSTxx 

MVS SUBSYS For the MVS subsystem list IEFSSNxx 


[ ~— {Internal DB2 Information ~~ = | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Mise eee End of Internal DB2 Information Siete oats 


Severity: 8 (error) 
System Action: The CLIST will continue. 


User Response: Check your entries for these fields on the MVS 
panel and make them exactly two characters. See job 
DSNTIJMV that was produced and correct the IEBUPDTE 
CHANGE statement. 


DSNT4511 WARNING-THE LOCAL DATE LENGTH OR LOCAL 


TIME LENGTH HAS BEEN INCREASED 


Explanation: The LOCAL DATE LENGTH or LOCAL TIME 
LENGTH has been increased and a REBIND command must be 
issued for any dependent plans. 


[ arias Internal DB2 Information ~ o 7 | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


[ie End of Internal DB2 Information eee, 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Rebind all application plans that depend upon 
the length of the local format that was changed. 


PARAMETER parm CANNOT BE CHANGED 
DURING MIGRATION 


DSNT4521 


Explanation: The parameter, 'parm', was changed on the 
panels, but the migration process does not permit this type of 
change. The active logs and boot strap data sets cannot be 
changed because they were set in the prior system and not 
redefined. The items in database DSNDBO01 are not defined 
except for the SCT02 table space and its index. 


| Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


(oe End of Internal DB2 Information soe peal 


Severity: 4 (warning) 
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System Action: The CLIST will continue, but the changes are 
removed. 


User Response: Determine if the changes are needed. If they 
are, refer to Section 2 (Volume 1) of Administration Guide for 
instructions regarding making changes to the parameters. 


DSNT4531 OUTPUT PREFIX CANNOT EQUAL LIBRARY 


PREFIX 


Explanation: The output prefix is used to create a new data set 
to contain edited jobs. It must not be the same as the library 
prefix, because some of the suffixes are the same and the cus- 
tomized data would replace the input data. The input data must 
be saved. 


Internal DB2 information ~~ | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


it eet End of Internal DB2 Information er 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
edited jobs. 


User Response: Specify a different output prefix. if you use the 
prefix of an existing data set, the existing data set will be 
deleted and reallocated. 


DSNT454] ERROR CODE = errcode, CNT = count 


Explanation: An error was encountered during CLIST proc- 
essing for reading the parameter member. Most of these 
errors are caused by having a mismatch between the level of 
the CLIST and that of the parameter member being read. 


The ‘errcode' is an error code defined for the CLIST. The error 
code values and associated meanings may be found in OS/VS2 
TSO Command Language Reference. 


The ‘count' value is the number of parameter values already 
read. 


ve = Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


eee ee End of Internal DB2 Information _ 


System Action: The CLIST will terminate. 


User Response: Be sure the parameter member and the CLIST 
are at the same level. 


Problem Determination: If you suspect an error in the process, 
set CONTROL(CONLIST) and invoke the CLIST in batch, so that 
the tracing can be sent with the error documentation. You will 
also need the listing of the CLIST and the parameter member 
being read. 


DSNT4551 ICF CATALOG OR ALIAS MUST NOT BE NULL 


Explanation: The ICF catalog or alias is used as the prefix for 
many data set names. It must be specified as a valid name. 


Internal DB2 information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


re End of internal DB2 Information sete | 


Severity: 8 (error) 


System Action: The CLIST will continue, but wil! not produce 
edited jobs. 


User Response: Specify a valid alias name for an ICF catalog. 


DSNT4561 


Explanation: The variable named 'varname' does not have a 
valid value. Its current value is 'value'. Subsequent messages 
will describe the reason the value is invalid and the action 
taken by the CLIST. 


ERROR IN VARIABLE varname, VALUE IS value 


If the error is in the CONTROL value, the value was specified 
when the CLIST was invoked. The value is not valid, and no 
additional tracing will be done. The permitted values are 
NONE, LIST, CONLIST, and SYMLIST. Each value produces 
more CLIST tracing information than those which precede it. If 
the error is in other values, the value was specified when the 
CLIST was invoked on the ISPF panels. 


[ Internal DB2 Information ~~ —~— | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Be eared End of Internal DB2 Information a | 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
jobs or parameter data. 


User Response: Check the subsequent messages. Exit, then 
invoke the CLIST with a valid value for the variable. 


Problem Determination: If you suspect an error in the process, 
set CONTROL(CONLIST) and invoke the CLIST in batch, so that 
the tracing can be sent with the error documentation. The 
CLIST itself and the parameter member read in should be sent 
as well. 


DSNT457E VALUES CANNOT BE THE SAME 


Explanation: You specified the same value for the IRLM startup 
procedure name (iIRLMPROC) and the IRLM subsystem ID 
(IRLMSSID) fields. These two fields must be different. 


| ae 4 Internal DB2 Information ~— | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


pee End of Internal DB2 Information ee 


Severity: 8 (error) 


System Action: The CLIST will continue, but wil! not produce 
edited jobs or parameter data. The CLIST also adds a 0 to the 
IRLM startup procedure name. 


User Response: Reenter the output parameter member and 
output data set prefix on the primary install panel. Reexecute 


DSNT456! — DSNT460I 


the CLIST. The CLIST will display the new values of the fields 
on the appropriate panel. You may either accept the new 
values or change them to other valid values. 


DSNT4581 VALUE MUST BE NUMERIC 


Explanation: The variable named in message DSNT456! must 
be an integer. Only digits are allowed, with no decimal point or 
fractions. If the value is a number suffixed by K or M, it is inter- 
preted as the indicated number multiplied by 1024 or 1048676. If 
any other non-numeric character is present in the value, or if 
the K or M is not the final character, this message is produced. 


[ ———_ Internal DB2 Information al: 


This message is issued by the following installation CLIST(s): 
DSNTINST 


[even eet End of Internal DB2 Information Sead 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
edited jobs or parameter data. 


User Response: This CLIST will continue, but will not produce 
edited jobs. The value of the variable has been set to the value 
shown in message DSNT465l. You will need to reenter the 
output parameter and output data set prefix. Examine the value 
and reset it if needed. 


DSNT4591 VALUE IS TOO LOW, MINIMUM IS min 


Explanation: The variable named in message DSNT456I must 
be larger than its current value. The minimum value allowed is 
‘min’. 


| : “——— Internal DB2 Information oe 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Moet 209 End of Internal DB2 Information et ee 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
edited jobs. The CLIST resets the incorrect value to ‘min'. 


User Response: See message DSNT465l for the CLIST action. 


DSNT4601 VALUE IS TOO HIGH, MAXIMUM IS max 


Explanation: The variable named in message DSNT456! must 
be smailer than its current value. The maximum value allowed 
is 'max'. 


a ~~~ Internal DB2 Information ~— | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


ae End of Internal DB2 Information ee 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
edited jobs. The CLIST resets the incorrect value to 'max'. 


User Response: See message DSNT465I for the CLIST action. 
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DSNT462! — DSNT467I 


DSNT4621 VALUE IS TOO LONG, MAXIMUM IS length CHAR- 


ACTERS 


Explanation: The variable named in message DSNT456/ must 
be shorter than its current value. The maximum length allowed 
is ‘length’. 


a a7 ms Internal DB2 Information 7 | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


We eens End of Internal DB2 Information _ 


Severity: 8 (error) 


System Action: The CLIST will continue; but will not produce 
edited jobs. The CLIST resets the value to the default value. 


User Response: See message DSNT4651 for the CLIST action. 


DSNT463! IF ONE VALUE IS ZERO, THEN ALL MUST BE 


ZERO 


Explanation: When you specify a value of zero for either the 
minimum 32K buffer pool (BUFMIN32), the maximum 32K buffer 
pool (BUFMAX32), the number of 32K temporary table spaces 
(NUM32KDS), or the space for the temporary table spaces 
(NUMTEMP2), all four of the fields must be zero. 


| internal DB2 Information ~—— ST | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


es End of Internai DB2 Information eee) 


Severity: 4 (warning) 


System Action: The CLIST will reset all four fields to zero and 
continue. 


User Response: Setting the values to zero will not permit 
tabies with rows longer than 4K. If you anticipate a need for 
larger tables, rerun the CLIST with values other than zero for all 
four fields. 


DSNT4641 VALUES PERMITTED ARE values 


Explanation: The variable named in message DSNT456I must 
be one of the 'values' listed. 


| — Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


= End of internal DB2 Information eeeeees) 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
edited jobs. 


User Response: See message DSNT465l for the CLIST action. 
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DSNT4651 VARIABLE varname SET TO value 


Explanation: The variable, 'varname', named in message 
DSNT456! is in error. Possible reasons for the error are listed 
in messages: DSNT458!, DSNT4591, DSNT460!, DSNT4621, 
DSNT463!, DSNT464I. 


| internal DB2 Information ~~ tl 


This message is issued by the following installation CLIST(s): 
DSNTINST 


End of Internal DB2 Information ey 


System Action: The CLIST will continue, but will not produce 
edited jobs. The value has been set to the value shown. 


User Response: Specify the output data again on the primary 
install panel. You will be able to see and change the value. if 
this value is not acceptable, change it, noting the limits. 


DSNT4661 OUTPUT MEMBER CANNOT BE DSNTIDVB OR 


DSNTIDXA 


Explanation: The output parameter member will be placed into 
DSN220.DSNSAMP. Members are supplied there with these 
names. You are not permitted to replace these members. 


[~ ~~ Internal DB2 information 7 a 


This message is issued by the following installation CLIST(s): 
DSNTINST 


[he End of Internal DB2 Information Fea ee 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
edited jobs or output the parameter member. 


User Response: Specify a different name for the output 
member. 


DSNT4671 OUTPUT MEMBER SHOULD BEGIN WITH DSNTID 


Explanation: The output parameter member will be placed into 
DSN220.DSNSAMP. This data set already has a large number 
of members. To avoid replacing a member that you need, a 
naming convention with prefix 'DSNTID' is strongly suggested. 
The suffixes 'VB' and 'XA' are not allowed (see message 
DSNT466)). 


[- _ Internal DB2 Information == | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


ee End of Internal DB2 Information _ 


Severity: 4 (warning) 
System Action: The CLIST will continue. 


User Response: Specify a different name for the output 
member. 


DSNT4681 ERROR(S) ENCOUNTERED, OUTPUT IS 


BYPASSED 


Explanation: An error was detected earlier in this run. 
Because of the error, data set editing was not performed. 


| internal DB2 Information = | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


| Ls End of internal DB2 Information ____| 


Severity: 8 (error) 


System Action: The CLIST will continue, but will not produce 
edited jobs. 


User Response: Correct the errors noted earlier, and specify 
the output prefix name again to produce the edited data. 


DSNT4691 INPUT PARAMETERS MUST BE READ BEFORE 


MIGRATION 


Explanation: The INPUT MEMBER NAME on panel DSNTIPA1 
must have a value to allow migration values to be read. This is 
to permit the new values to be initialized. 


= 2 oss Ss Internal DB2 Information ~~ ——4 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Ls End of Internal DB2 Information ____——_| 


Severity: 8 (error) 


System Action: The CLIST will return to the main instal! panel, 
DSNTIPA1. 


User Response: Specify DSNTIDXA as the INPUT MEMBER 
NAME and specify the current value for the migration member. 


DSNT4701 WARNING, ONLY ONE VOLUME WAS SPECIFIED 


Explanation: Only one volume serial number was specified on 
the install panel or CLIST invocation. This does not allow ade- 
quate recovery or performance unless it is intended to be a 
single volume test system. 


[ a= Internal DB2 Information 


This message is issued by the following installation CLIST(s): 
DSNTINST 


oe a= End of Internal DB2 Information Spee | 


Severity: 4 (warning) 
System Action: The CLIST will continue. 


User Response: If this subsystem is intended to be recover- 
able, more than one volume is needed. Rerun the installation 
tailoring process, specifying at least one more volume on the 
DSNTIPA2 panel. If this is just a single volume test system, be 
sure that you specify a single copy of the tog data sets. The 
boot strap data sets are small and not active, so that two are 
recommended even on a single volume system. 


DSNT468I — DSNT475I 


DSNT4711 BEGINNING PARAMETER INPUT MEMBER inmem 


Explanation: The input parameter member, 'inmem’, is being 
read. This data includes values for all of the installation param- 
eters. 


_— ~~~ _ Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Serer eran End of Internal DB2 Information are 


Severity: 0 (successful execution) 


System Action: The CLIST will continue. 


DSNT4731 =BEGINNING CHECK PHASE 


Explanation: This message indicates the following: 


¢ The values entered on the panels are being checked. 
¢ Values which use the K or M suffix are being translated to 
numbers. 


[ «Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Restos End of Internal DB2 Information Seal 


Severity: 0 (successful execution) 


System Action: The CLIST will continue. 


DSNT474l READING count, varname, datatype, minval, 


maxval, currentval 


Explanation: The values are being read from the parameter 
member. The count, the variable name, the data type, the 
minimum value, the maximum value, and the current value are 
shown. This message occurs when the CONTROL keyword 
requests a trace. 


>. Internal DB2 Information << 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Lo End of Internal DB2 information a: 


System Action: The CLIST will continue. 


Severity: 0 (successful execution) 


DSNT4751 CHECK count, varname, type, minval, maxval, 


currentval 
Explanation: This message indicates the following: 


¢ The values read in or entered on the panels are being 
checked. 

e Vatues which use the K or M suffix are being translated to 
numbers. 


The count, the variable name, the data type, the minimum 
value, the maximum value, and the current value are shown. 
This message occurs when the CONTROL keyword requests a 
trace. 
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DSNT476I — DSNT487I 


[ oo ~~ _ Internal DB2 Information es | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


tan End of Internal DB2 Information sie ett oe 


Severity: 0 (successful execution) 
System Action: The CLIST will continue. 


DSNT476 BEGINNING PARAMETER OUTPUT MEMBER 


outmem 


Explanation: The output parameter member named 'outmem' 
is being written. This data includes values for all the install 
parameters. 


[ —-—«s[nternal DB2 Information 


This message is issued by the following installation CLIST(s): 
DSNTINST 


Ue ees End of Internal DB2 Information ee 


Severity: 0 (successful execution) 
System Action: The CLIST will continue. 


DSNT477I OUTPUT count, varname, type, minval, maxval, 


currentval 


Explanation: The values entered on the panels are being 
written to the output parameter member. The count, the vari- 
able name, the data type, the minimum value, the maximum 
value, and the current value are shown. This message occurs 
when the CONTROL keyword requests a trace. 


fet ee internal DB2 Information 7s | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


(eee Sees End of Internal DB2 Information Eee ee] 


Severity: 0 (successful execution) 


System Action: The CLIST will continue. 


DSNT478i = BEGINNING EDITED DATA SET OUTPUT 


Explanation: The output jobs and data are being edited to 
tailor them. Edited JCL output was requested and no severe 
errors were encountered. 


[~ ~~~ _ Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


ee End of Internal DB2 Information ees 


Severity: 0 (successful execution) 


System Action: The CLIST will continue. 
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DSNT4851_ _—s type SIZE = size K 


Explanation: This is the estimated main storage size for part of 
the DB2 database address space. This is the most constrained 
address space. The 'type' can be BUFFER POOL, EDMPOOL 
STORAGE, DATA SET STORAGE, CODE STORAGE, or 
WORKING STORAGE. 


The storage for buffer pools, EDMPOOL, and code is above the 
16M line. Most of the main storage for data set control blocks is 
below the 16M line and is included in the region size. Working 
storage includes storage above and below the 16M line, but 
storage above the line is not included in the region. Refer to 
Section 2 (Volume 1) of Administration Guide for more informa- 
tion regarding this calculation. 


— ee internal DB2 Information ~ | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


eae eee End of Internal DB2 Information Pe SS eet 


Severity: 0 (successful execution) 


System Action: The CLIST continues. 


DSNT4861 TOTAL MAIN STORAGE = totregion K 


Explanation: This is the estimated total region size. It includes 
storage above the 16M line. Refer to Section 2 (Volume 1) of 
Administration Guide for more details regarding this calcu- 
lation. 


SS ~ Internal DB2 Information ~ | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


{End of Internal DB2 information ____——_— 


Severity: 0 (successful execution) 
System Action: The CLIST continues. 


DSNT4871 TOTAL STORAGE BELOW 16M = region K 


(ASSUMING SWA IS ABOVE THE LINE) 


Explanation: This message provides an estimate of the virtual 
storage required below the 16M line to check for virtual storage 
constraints. This calculation presumes that you have moved 
the SWA for DB2 above the 16M line. Refer to Section 2 
(Volume 1) of Administration Guide for details regarding this 
calculation. 


i — Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


[tas eee End of Internal DB2 Information cate Sena 


Severity: 0 (successful execution) 
System Action: The CLIST continues. 


User Response: Check for virtual storage constraints. Your 
MVS should permit at least this amount of virtual storage below 
the 16M line. 


DSNT488i VOLUME voin WILL REQUIRE AT LEAST nn 4K 


BLOCKS 


Explanation: This message states the number of 4K blocks of 
space that will be required for the specified volume in order to 
install or migrate the current release of DB2. 


Volume 'voin' is specified in the VOLUME SERIAL fields on 
install panel DSNTIPA2, or with the VOLSDATn input parame- 
ters to the Install CLIST. The message indicates how much 
space will be needed on the selected volume to install or 
migrate this release of DB2. 


| Internal DB2 Information | 


This message is issued by the following installation CLIST(s): 
DSNTINST 


[i ornare Se cn od End of Internal DB2 information a ete atl 


Severity: 0 (successful execution) 
System Action: Processing continues. 


User Response: Ensure that the volume has at least as much 
available storage as the message indicates it should have. If it 
does not, rerun the Install CLIST specifying different volumes, 
or create more available space on the originally specified 
volume. 


In order to convert the number of 4K blocks required to the 
number of cylinders required, use the table below. Divide the 
number of 4K blocks (in the DSNT488I message) by the number 
of 4K blocks per cylinder (in the table) to get the number of cyl- 
inders required. 


Device 4K Blocks 4K Blocks 
Type per Cylinder per Track 
3330 57 3 
3340 24 2 
3350 120 4 
3375 96 8 
3380 150 10 


These size estimates are for system data only. They do not 
include: user data, archive logs, image copies, or temporary 
work data sets other than the temporary database. 


DSNT489I 


Explanation: The CLIST has finished editing the data set and 
member, 'dsname(member)'. The 'explanation' is the type of 
data that was edited. The possible values for the explanation 
are: 


INSTALL JCL 


CLIST EDITED dsname(member), explanation 


Jobs to be edited and run as directed during 
the install process. 
MIGRATE JCL Jobs to be edited and run as directed only 
during the migration process. 
FALL BACK JCL 
A job that is only to run as directed during a 
fall back to the previous release. 
RECOVERY JCL 
A job that is only to run as directed during a 
recovery process. It deletes the DB2 data 
sets. 
Jobs to be edited and run during the installa- 
tion verification to add the sample application. 
SAMPLE DATA Edited data that the installation verification 
jobs require. 
CLIST Customized CLISTs to reflect your names that 
are used during the install process. 


SAMPLE JCL 


DSNT488i — DSNT492I 


a. ~ Internal DB2 information —— 


This message is issued by the following installation CLIST(s): 


DSNTINST DSNTINS1 DSNTINS2 
DSNTINM1 DSNTINM2 


——— ar End of Internal DB2 Information ee 


Severity: 0 (successful execution) 


System Action: The CLIST will continue. 


DSNT4901 SAMPLE DATA UNLOAD PROGRAM 2.0 


Explanation: This is the header, indicating a normal start for 
the application program. 


| ~~ Internal DB2 Information . | 
This message is issued by the following CSECT(s): DSNTIAUL 


{ End of Internal DB2 Information ee et 


DSNT4911 TOO MANY TABLES ENTERED (MAXIMUM OF 100 


TABLES) 


Explanation: The number of tables entered for unloading 
exceeded the maximum of 100 tables. The first 100 tables in the 
input should have been processed. 


| ~— Internal DB2 Information = == 
This message is issued by the following CSECT(s): DSNTIAUL 


ae End of Internal DB2 Information eet asl 


System Action: The application program is terminated. 


User Response: Split the run into multiple runs, none with 
more than 100 tables. 


Problem Determination: Check the application program input. 
Make sure there are no more than 100 tables. 


DSNT492t SQL WARNING DURING SQL STATEMENT func 


Explanation: The SQL statement may not be executed cor- 
rectly. The function 'func' may be PREPARE, OPEN, FETCH, or 
CLOSE, indicating the type of SQL statement encountering the 
error. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTIAUL 


fis es he et End of Internal DB2 Information teeta 


System Action: The request may not be executed correctly. 


User Response: Refer to “Section 2. SQL Return Codes” on 
page 2-1. 


Problem Determination: Determine which SQL statement in the 
application program caused the warning and see if it is repro- 
ducible. Follow the diagnosis approach suggested for the 
warning. 
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DSNT4931 — DSNT498! 


DSNT4831 SQL ERROR DURING SQL STATEMENT func 


Explanation: The SQL statement may not be executed cor- 
rectly. The function 'func' may be PREPARE, OPEN, FETCH, or 
CLOSE, indicating the type of SQL statement encountering the 
error. 


[ ~~ Internal DB2 Information —_ | 
This message is issued by the following CSECT(s): DSNTIAUL 


re End of internal DB2 Information ee ee 


System Action: The request was not executed correctly. 


User Response: Refer to “Section 2. SQL Return Codes” on 
page 2-1. 


Probiem Determination: Determine which SQL statement in the 
application program caused the error and see if it is reproduc- 
ible. follow the diagnosis approach suggested for the SQL 
return code. 


DSNT494 ERROR DURING OPEN OF DDNAME SYSRECnn 


Explanation: The ddname listed, where 'nn' ranges from 00 to 
99, could not be successfully opened. A possible reason is that 
the DD statement to the data set was not present in the JCL. 


| : Internal DB2 Information ————. a 
This message is issued by the following CSECT(s): DSNTIAUL 


Uh eran End of Internal DB2 Information ee 


System Action: The application program is terminated. 


User Response: Check the JCL to ensure that this DD state- 
ment is provided and is able to be used for output. 


Problem Determination: Make sure that the same number of 
DD statements and table names were provided. 


DSNT4951 SUCCESSFUL UNLOAD n ROWS OF TABLE tttttttt 


Explanation: The message indicates that 'n' rows of table or 
view 'tttttttt' were unloaded. The 'n' rows were counted 
during the unload processing. 


Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNTIAUL 


eer End of Internal DB2 Information pe ee 


System Action: The request was executed successfully. 


DSNT4961 UNRECOGNIZED DATA TYPE CODE OF nnnnn 


Explanation: The PREPARE returned an invalid data type code 
of decimal 'nnnnn'. 
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oe ee Internal DB2 Information en area | 
This message is issued by the following CSECT(s): DSNTIAUL 


ae End of Internal DB2 Information eet es | 


System Action: The next table is processed. 
User Response: Notify the system programmer. 


System Programmer Response: See the Problem Determi- 
nation section. 


Problem Determination: There is an error in the unload 
program or a new data type has been added. The recognized 
data types are fullword integer, halfword integer, fixed length 
character, variable length character, packed decimal, floating 
point, fixed length graphic, variable length graphic, and long, 
variable length graphic. 


DSNT4971 RETURN CODE FROM MESSAGE ROUTINE 


DSNTIAR 


Explanation: The message formatting routine detected an 
error. 


LF — Internal DB2 Information zee 
This message is issued by the following CSECT(s): DSNTIAUL 


| Ena of Internal DB2 Information _______—_—| 


System Action: The application program is terminated. 
User Response: Notify the system programmer. 


System Programmer Response: See the Problem Determi- 
nation section. 


Problem Determination: There is an error in the unload 
program. The return code from DSNTIAR is given in the MVS 
output of your job. When reporting this problem, have the 
return code, the application program listing, and JCL available. 


DSNT4981 ERROR, NO VALID COLUMNS FOUND 


Explanation: The PREPARE returned data which did not 
produce a valid output record. The data was not recognized as 
valid, so the columns were not unloaded. 


Internal DB2 Information — oe 7 
This message is issued by the following CSECT(s): DSNTIAUL 


End of Internal DB2 Information eee 


System Action: The next table is processed. 
User Response: Notify the system programmer. 


System Programmer Response: See the Problem Determi- 
nation section. 


Problem Determination: There is an error in the unload 
program. When reporting this problem, have the application 
program listing and its JCL available. 


DSNT5001 = csect-name RESOURCE UNAVAILABLE REASON 


reason TYPE type NAME name 


Explanation: The requested function requires a resource that 
is currently unavailable. In conjunction with other messages 
this message will identify the system action and the action that 
should be taken by the installation or operator. 


‘type’ and 'name' identify the resource that is currently una- 
vailable. The type code identifies the type, format, and content 
of the resource named. 


Operator Response: Note the reason code, the type code, and 
the name. See the Problem Determination section for an expla- 
nation of the collected data. 


Problem Determination: The reason the resource is unavail- 
able is identified by a reason code. The reason codes that 
appear in this message are described in “Section 4. DB2 
Codes” on page 4-1. Use Figure 4 in Appendix B, “Problem 
Determination” on page X-5 to find the type of resource identi- 
fied in the message. 


If type is 'DOO'x, the table name can be determined by using 
the following SQL statement: 


SELECT CREATOR, NAME 
FROM SYSIBM.SYSTABLES 
WHERE DBID = dbid AND OBID = obid; 


However, if the failing table has been dropped, then the above 
SELECT fails or possibly might return an incorrect name. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 1. 


DSNTSO1Il csect-name RESOURCE UNAVAILABLE 
CORRELATION-ID id1 

CONNECTION-ID id2 

LUW-ID id3 


REASON reason TYPE type NAME name 


Explanation: The requested function requires a resource that 
is currently unavailable. This message is used with other mes- 
sages that identify the system action and the action that should 
be taken by the installation or operator. 


file 

id1 The correlation identifier of the thread associated 
with the requestor of the resource. 

id2 The connection identifier of the requestor. 

id3 The logical-unit-of-work identifier (LUW-ID) of the 


thread associated with the requestor of the 
resource. An '*' indicates that the thread does not 
have a LUW-ID. If the LUW-ID is not an '*', the value 
is a logical-unit-of-work-id that is assigned to the 
thread followed by an '=' sign and a token value 
which may be used in place of logical-unit-of-work-id 
in any DB2 command that accepts logical-unit-of- 
work-id as input. 


type The type of resource that is currently unavailable. 
The 'type' identifies the type, as well as the format 
and content, of the resource 'name'. 

name The name of the resource that is currently unavail- 
able. 

reason The reason code. 


Operator Response: Note the 'reason' code, the 'type' code, 
and the 'name'. See Problem Determination for an explana- 
tion of the collected data. 


DSNT5001 — DSNT603I 


Problem Determination: The reason the resource is unavail- 
able is identified by a reason code. The reason codes that 
appear in this message are described in “Section 4. DB2 
Codes” on page 4-1. Refer to Figure 4 0n page X-7 to find the 
type of resource identified in the message. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 1. 


DSNT601! THE DESCRIPTOR FOR type name DOES NOT 


EXIST IN DBDO1 


Explanation: This message is issued for multiple-line WTO. 
The database, table space, or index space 'name' is in the DB2 
catalog but a descriptor for the object does not exist in the 
DBD01 table space of database DSNDBO01. This error can be 
produced when one of the following is true: 


¢ The Release 3 catalog has been migrated into Version 2. 
There is an object in the Version 2 catalog but there is not a 
descriptor for the object in the Version 2 directory (DBDO1). 


¢ The user did not completely restore the DBD01 table space 
during a recovery process. 


* There is a DB2 logic error. DSN389l is a multiple-line WTO 
message. 


In the message, 'type' is either 'DATABASE' or 'SPACE' and 
'‘name' is the eight character name of the database, table 
space, or index space. 


a Internal DB2 Information ee 
This message is issued by the foliowing CSECT(s): DSNTDMUL 


[ete eta End of Internal DB2 Information ee 


System Action: The process continues normally. 


System Programmer Response: Refer to Section 4 of Diag- 
nosis Guide and Reference for procedures to recover the 
DBD01 table space. 


DSNT602i NO SPACES FOUND 


Explanation: This message is issued for multiple fine WTO. It 
is produced when a DISPLAY DB(name) SPACENAM(...) is 
entered and no spaces were found to satisfy the request: 
SPACENAM(...) might have been entered as a range, a subset, 
or a list of spaces. 


ee > ————~_ internal DB2 Information Seer se fl 
This message is issued by the following CSECT(s): DSNTDMUL 


[eS cee End of internal DB2 Information eee 


DSNT6031 spacetype name NOT type 


Explanation: This message is issued for multiple-line WTO. It 
is produced when no table space or index space listed in the 
DISPLAY DB(...) SPACENAM(...) satisfies your request. 


spacetype TABLESPACE if the space is a table space or 
INDEXSPACE if the space is an index space. 

name The name of the space. 

type A character string that indicates the type of 


request specified. The string is a list of the fol- 
lowing, delimited by 'OR': 
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DSNT604I — DSNT704I 


¢ 'ACTIVE' if the keyword ACTIVE is specified 


¢ ‘'RESTRICTED' if the keyword RESTRICT is 
specified. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTDMUL 


a End of Internal DB2 Information Be ae ee 


System Action: Message DSNT301! or DSNT302! is produced if 
no object is found and the keywords ACTIVE and RESTRICT are 
omitted. 


DSNT604I NO INFORMATION AVAILABLE 


Explanation: This message is issued for multiple line WTO. It 
is produced when there is no LOCK or USE information avail- 
able. When DISPLAY DB(name) SPACENAM(...) is entered, and 
SPACENAM(...) is a list of spaces, this message indicates that 
no table spaces or index spaces whose names are listed have 
LOCK or USE information available. If DISPLAY DB(name) 
SPACENAM(...) is entered, and SPACENAM(...) is a range ora 
subset of spaces, no table spaces and index spaces within the 
specified database have LOCK or USE information available. 
This message is produced only when the keywords USE and 
LOCKS are specified. 


| ; Internal DB2 Information ee ae 
This message is issued by the following CSECT(s): DSNTDMUL 


[End of Internal DB2 Information ____] 


DSNT7001_ _—ittable-name IS THE ACTIVE RESOURCE LIMIT 


SPECIFICATION TABLE 


Explanation: This is a response message to the DISPLAY 
RLIMIT command. The resource limit facility (governor) is cur- 
rently active and is using table 'table-name' to determine 
resource limits. 


Pare any Internal DB2 Information a ae ell 
This message is issued by the following CSECT(s): DSNTCDIS 


ee rere End of Internal DB2 Information oe) 


System Action: The system continues normal processing. 
User Response: See Operator Response. 


Operator Response: To have the governor active while uti- 
lizing a different resource limit specification table, issue the 
START RLIMIT command specifying the ID of the desired table. 
if you do not want the facility to be active, issue the STOP 
RLIMIT command. 


System Programmer Response: May be used to resolve 
questions about what table is being used. 


DSNT701l RESOURCE LIMIT FACILITY IS INACTIVE 


Explanation: This is a response message to the DISPLAY 
RLIMIT command. It results whenever the governor is not 
active. 
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——— Internal DB2 Information pee ee al 
This message is issued by the following CSECT(s): DSNTCDIS 


ee eee End of Internal DB2 Information eet 


System Action: Normal processing continues. 
User Response: See Operator Response. 


Operator Response: If you want to activate the governor, 
specify the ID of the Resource Limit Specification Table to be 
used and issue the START RLIMIT command. 


System Programmer Response: /f the facility is already active 
(that is, a DSNT703 message was previously received), verify 
that the DSNT703 message appeared before the DISPLAY 
RLIMIT command was entered. If uncertain, reissue the 
DISPLAY RLIMIT command. If the problem persists, refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 


DSNT7021 RESOURCE LIMIT FACILITY HAS BEEN STOPPED. 


WAS USING table-name 


Explanation: This message is the normal response for a STOP 
RLIMIT command. Table ‘'table-name' was being used to 
determine resource limits. 


[ ~~ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNTCSTP 


(eee desea End of Internal DB2 Information re 


System Action: The governor is stopped. 


System Programmer Response: May be used to resolve 
questions about what table was being used. 


DSNT7031 RESOURCE LIMIT FACILITY IS ALREADY INAC- 


TIVE. STOP LIMIT COMMAND IS IGNORED. 


Explanation: A STOP RLIMIT command was entered but the 
resource limit facility was already stopped. The command is 
ignored. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTCSTP 


ee End of Internal DB2 Information ie oa 


System Action: The system continues normal processing. 


DSNT7041_ ~—stable-name HAS BEEN STARTED FOR THE 


RESOURCE LIMIT FACILITY 


Explanation: This message is the normal response for a 
START RLIMIT command. Table 'table-name' is currently 
being used to determine resource limits. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTCSRS 


a End of Internal DB2 Information eat ao 


System Action: The governor has started utilizing the specified 
table. 


System Programmer Response: May be used to resolve 
questions about what table is being used. 


DATABASE name CANNOT BE STOPPED. IT CON- 
TAINS THE RESOURCE LIMIT SPECIFICATION 
TABLE. 


DSNT7051 


Explanation: The database specified in the message cannot be 
stopped because it contains the active Resource Limit Specifi- 
cation Table. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNTDMSG 


a eee End of Internal DB2 Information tee 


System Action: The database specified in the message is not 
stopped. 


User Response: See Operator Response. 


Operator Response: The named database cannot be stopped 
because it contains the active resource limit specification table. 
If the database must be stopped, then the governor must either 
be stopped (STOP RLIMIT) or switched to use a resource limit 
specification table which is NOT in the database (START 
RLIMIT,ID = xx). 


DSNT706I table-name DOES NOT EXIST. START LIMIT 


COMMAND FAILED. 


Explanation: The START RLIMIT command has been entered 
but failed because table 'table-name' does not exist. 


- Interna! DB2 Information : | 
This message is issued by the following CSECT(s): DSNTCSRC 


a sees End of Internal DB2 Information eter 


System Action: The START RLIMIT command is ignored. 
User Response: See Operator Response. 


Operator Response: Verify that the 1 or 2 characters following 
DSNRLST are what was intended to be entered as the ID on the 
START RLIMIT command. If not, reenter the command speci- 
fying the proper ID. If the ID appears correct, contact the 
system programmer. 


System Programmer Response: DB2 was unable to find the 
specified table in the catalog. Verify that the FULLY QUALIFIED 
name is the one expected. The tabie name is built by 
appending the 1 or 2 character iD specified on the START 
RLIMIT command to the authorization ID.DSNRLST. The author- 
ization ID is determined from the DSNZPARMs used when 
starting the subsystem. 


DSNT7051 — DSNT708! 


If everything appears to be in order, from a TSO terminal with 
the proper authorization, enter the following SQL statement: 


SELECT * FROM SYSIBM.SYSTABLES 
WHERE NAME = DSNRLSTxx & CREATOR = authorization ID 
Where 


DSNRLSTxx 
authorization ID 


Table-name starting with the DSNRLST 
Table-name up to but not including the period. 


If an entry is found, save the output and refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items: 


¢ Console output showing the failing START command 
¢ The output of the SELECT command. 


DSNT7071 START RLIMIT COMMAND FAILED. COLUMN 
column-name IN TABLE table-name IS INCOR- 
RECTLY DEFINED. THE COLUMN DEFINITION IS 
attribute WITH LENGTH length AND NULL ATTAI- 
BUTE null-attribute. THE COLUMN DEFINITION 
SHOULD BE attribute WITH LENGTH length AND 


NULL ATTRIBUTE null-attribute. 


Explanation: The START RLIMIT command has been entered 
but failed because TABLE 'table-name' does not have the 
proper column definition for a resource limit specification table. 
The current column definition is given as well as the proper 
column definition. 


<2 Internal DB2 Information Fa nd 
This message is issued by the following CSECT(s): DSNTCSRC 


eae eees End of Internal DB2 Information _ 


System Action: The START RLIMIT command is ignored. 
User Response: See Operator Response. 


Operator Response: Verify that the 1 or 2 characters following 
DSNRLST are what was intended to be entered as the ID on the 
START RLIMIT command. If not, reenter the command speci- 
fying the proper ID. If the ID appears to be correct, contact the 
system programmer. 


System Programmer Response: TABLE 'table-name' does not 
have the proper column definition for a resource limit specifica- 
tion table. Compare the current table column definition to the 
proper column definition given in the message. 


Problem Determination: Collect the console output showing 
the failing START command. 


DSNT708! INDEX index-name DOES NOT EXIST. START 


RLIMIT COMMAND FAILED. 


Explanation: The START RLIMIT command has been entered 
but failed because INDEX DSNARLxx does not exist for the cor- 
responding resource limit specification table, DSNRLSTxx. 


Internal DB2 Information ~— 
This message is issued by the following CSECT(s): DSNTCSRC 


ee End of Internal DB2 Information ee ee 


System Action: The START RLIMIT command is ignored. 
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DSNT709!1 — DSNT712I 


User Response: See Operator Response. 


Operator Response: Verify that the 1 or 2 characters following 
DSNRLST are what was intended to be entered as the ID on the 
START RLIMIT command. If not, reenter the command speci- 
fying the proper ID. If the ID appears to be correct, contact the 
system programmer. 


System Programmer Response: The resource limit specifica- 
tion table DSNRLSTxx does not define the required index 
DSNARLxx. Create the required index and reissue the START 
RLIMIT command. 


Problem Determination: Collect the console output showing 
the failing START command. 


DSNT709I new-table-name NOW ACTIVE. old-table-name 


WAS OLD RESOURCE LIMIT:SPECIFICATION 
TABLE. 


Explanation: A START RLIMIT command was entered while the 
facility was already active. The facility remains active and 
switches from using the old table name to the new one. 


Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNTCSRS 


enn ee End of Internal DB2 Information gies S| 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. 


DSNT7101 =table-name ALREADY ACTIVE. START LIMIT 


COMMAND IGNORED. 


Explanation: A START RLIMIT command was entered and the 
governor is already active utilizing the specified table. The 
command is ignored. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTCSTR 


Ua ogame ce End of Internal DB2 Information settee 


System Action: The governor continues to use table 
'table-name'. 


User Response: See Operator Response. 


Operator Response: Verify that the ID specified on the START 
RLIMIT command was the one desired. If not, reenter the 
command specifying the correct ID. If it is correct, no action is 
needed since the facility is already active and is using the 
desired table. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 
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DSNT7111 COLUMN column-name IS MISSING IN TABLE 
table-name. SHOULD BE DEFINED AS attribute 
WITH LENGTH length AND NULL INDICATOR OF 


null-attribute. 


Explanation: The START RLIMIT command has been entered 
but failed because COLUMN 'column-name' in resource limit 
specification table 'tabie-name' is not defined. The proper 
column definition is given in the message. 


[ge = Ease oe internal DB2 Information eS a 
This message is issued by the following CSECT(s): DSNTCSRC 


ae End of Internal DB2 Information ee 


System Action: The START RLIMIT command is ignored. 
User Response: See Operator Response. 


Operator Response: Verify that the 1 or 2 characters following 
DSNRLST are what was intended to be entered as the ID on the 
START RLIMIT command. If not, reenter the command speci- 
fying the proper ID. If the ID appears to be correct, contact the 
system programmer. 


System Programmer Response: TABLE 'table-name' does not 
have COLUMN 'column-name' defined. Use ALTER TABLE to 
define the column as specified in the message. 


Problem Determination: Collect the console output showing 
the failing START command. 


DSNT7121 = INDEX index-name IS NOT FOR TABLE table- 


name. START RLIMIT COMMAND FAILED. 


Explanation: The START RLIMIT command has been entered 
but failed because INDEX 'index-name' is not defined for 
Resource Limit Specification Table 'table-name'. 


oo Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNTCSRC 


[ceo nee End of Internal DB2 information _ 


System Action: The START RLIMIT command is ignored. 
User Response: See Operator Response. 


Operator Response: Verify that the 1 or 2 characters following 
DSNRLST are what was intended to be entered as the ID on the 
START RLIMIT command. If not, reenter the command speci- 
fying the proper ID. if the ID appears to be correct, contact the 
system programmer. 


System Programmer Response: INDEX 'index-name' is not 
defined in resource limit specification table 'table-name’. 
resource limit specification table DSNRLSTxx does not define 
the required index DSNARLxx. The last two characters of the 
table name correspond to the last two characters of the the 
index. Drop the existing DSNARLxx index and create the 
correct index in the resource limit specification Table. 


Probiem Determination: Collect the console output showing 
the failing START command. 


DSNT713f = INDEX index-name IS NOT UNIQUE. START 


RLIMIT COMMAND FAILED. 


Explanation: The START RLIMIT command has been entered 
but failed because INDEX 'index-name' in the Resource Limit 
Specification Table is not defined as a UNIQUE index. 


[~ ~— Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTCSRC 


[| seEnd of internal DB2 Information ____———_ 


System Action: The START RLIMIT command is ignored. 
User Response: See Operator Response. 


Operator Response: Verify that the 1 or 2 characters following 
DSNRLST are what was intended to be entered as the ID on the 
START RLIMIT command. If not, reenter the command speci- 
fying the proper !D. If the ID appears to be correct, contact the 
system programmer. 


System Programmer Response: INDEX ‘index-name' in 
Resource Limit Specification Table is not UNIQUE. Redefine it 
as unique. 


Problem Determination: Collect the console output showing 
the failing START command. 


DSNT7141 INDEX index-name IS INCORRECTLY DEFINED. 


START RLIMIT COMMAND FAILED. 


Explanation: The START RLIMIT command has been entered 
but failed because INDEX ‘index-name' in Resource Limit 
Specification Table 'table-name' is not properly defined. 


[eos ae Internal DB2 Information ~ ee 
This message is issued by the following CSECT(s): DSNTCSRC 


ene End of Internal DB2 Information ee a 


System Action: The START RLIMIT command is ignored. 
User Response: Contact the system programmer. 
Operator Response: . Contact the system programmer. 


System Programmer Response: INDEX ‘index-name' in the 
Resource Limit Specification Table does not have the proper 
definition. Refer to Section 5 of Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the console output showing 
the failing START command. 


DSNT715E ERROR reason-code READING table-name. 
default WILL BE RESOURCE LIMIT FOR 
CORRELATION-ID correlation-id, CONNECTION-ID 


connection-id, LUW-ID luw-id =token 


Explanation: An error occurred while the resource limit spec- 
ification table 'table-name' was being read. The limit is deter- 
mined from the default specified in the system parameters. 
This default can be: 


NOLIMIT No limit applies. 
NORUN  Zero-time limit. 
integer _ The limit to be used. 


The reason code that defines the read error is included in the 
message text, as are the connection ID, correlation ID, and the 


DSNT7131 — DSNT716E 


logical-unit-of-work identifier (LUW-ID) of the thread. An 
LUW-ID of an '*' indicates that the thread does not have a 
LUW-ID. If the LUW-ID is not an '*', the value is a logical-unit- 
of-work-id that is assigned to the thread followed by an '=' 
sign and a token value which may be used in place of logical- 
unit-of-work-id in any DB2 command that accepts logical-unit- 
of-work-id as input. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTCGET 


ere End of Internal DB2 Information Se ateeaest a) 


System Action: Processing continues using the system-defined 
default. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is an {/O error. Investi- 
gate the problem indicated by the reason code and preceding 
messages. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 


DSNT716E AN ERROR OCCURRED ESTABLISHING A 
RESOURCE LIMIT FOR CORRELATION-ID 
correlation-id, CONNECTION-ID connection-id, 
LUW-ID luw-id =token. limit WILL BE USED AS 


THE LIMIT. 


Explanation: An internal error occurred while the resource 

limit for the specified requester was being established. The 

‘limit' is determined from the default specified in the system 
parameters. This default can be: 


NOLIMIT No limit applies. 
NORUN = Zero time limit. 
integer The limit to be used. 


A logical-unit-of-work identifier (LUW-ID) of '*' indicates that 
the thread does not have a LUW-ID. If the LUW-ID is not an '*', 
the value is a logical-unit-of-work-id that is assigned to the 
thread followed by an '=' sign and a token value which may 
be used in place of logical-unit-of-work-id in any DB2 command 
that accepts logical-unit-of-work-id as input. 


Internal DB2 Information een we ae 
This message is issued by the following CSECT(s): DSNTCGET 


eee eet End of Internal DB2 Information ee | 


System Action: Processing continues using the system-defined 
default. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 
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DSNT7171 TABLESPACE name CANNOT BE STOPPED. IT 


CONTAINS THE ACTIVE RESOURCE LIMIT SPEC- 
IFICATION TABLE. 


Explanation: TABLESPACE 'name' cannot be stopped 
because it contains the active Resource Limit Specification 
Table. 


ce a ia internal DB2 Information . 
This message is issued by the following CSECT(s): DSNTDMSG 


ieee tes End of Internal DB2 Information _ 


System Action: TABLESPACE 'name' is not stopped. 
User Response: See Operator Response. 


Operator Response: TABLESPACE 'name' cannot be stopped 
because it contains the active resource limit specification table. 
If the table space must be stopped, then the governor must 
either be stopped (STOP RLIMIT) or switched to use a resource 
limit specification table which is NOT in the table space (START 
RLIMIT,ID = xx). 


DSNT7181 INDEXSPACE name CANNOT BE STOPPED. IT IS 


DEFINED ON THE ACTIVE RESOURCE LIMIT 
SPECIFICATION TABLE. 


Explanation: INDEXSPACE 'name' cannot be stopped because 
it is defined in the active Resource Limit Specification Table. 


[ ~~~ Internal DB2 Information is 
This message is issued by the following CSECT(s): DSNTDMSG 


ee End of Internal DB2 Information eee te 


System Action: INDEXSPACE 'name' is not stopped. 
User Response: See Operator Response. 


Operator Response: INDEXSPACE 'name' cannot be stopped 
because it is defined in the active resource limit specification 
table. if the index space must be stopped, then the governor 
must either be stopped (STOP RLIMIT) or switched to use a dif- 
ferent Resource Limit Specification Table. 


DSNT7191 TABLE table-name CANNOT BE READ. START 


RLIMIT COMMAND FAILED. 


Explanation: TABLE 'table-name' cannot be accessed. This 
message may be preceded by related error messages that 
explain why the table cannot be accessed. 


[ee oe oe Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTCSRC 


[| sEna of Internal DB2 Information __._— | 


System Action: The START RLIMIT command failed. 
User Response: See Operator Response. 


Operator Response: TABLE 'table-name' cannot currently be 
accessed for reading. In the case of a deadlock or timeout, 
reissue the START RLIMIT command. 
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DSNT720!1 INDEX index-name NEEDS TO BE ASCENDING. 


Explanation: The START RLIMIT command was entered but 
failed because the named index defined for the resource limit 
specification table is not defined properly. All the index 
columns need to be ascending. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNTCSRC 


aver eee: End of Internal DB2 information Sere, 


System Action: The system ignores the START RLIMIT 
command. 


User Response: Contact the system programmer. 
Operator Response: Contact the system programmer. 


System Programmer Response: The named index defined on 
the resource limit specification table does not have the proper 
definition. 


Problem Determination: Collect the console output showing 
the failing START command. 


DSNT7211 DATABASE name CANNOT BE STARTED WITH 
ACCESS (UT). IT CONTAINS THE ACTIVE 


RESOURCE LIMIT SPECIFICATION TABLE. 


Explanation: The database specified in the message cannot be 
started with access (UT) because it contains the active resource 
limit specification table. 


oe =. internal DB2 Information ~~ — 7. ee 
This message is issued by the following CSECT(s): DSNTDCST 


Vie ees ae End of Internal DB2 Information ae 


System Action: The START DATABASE command is ignored. 
User Response: See Operator Response. 


Operator Response: DATABASE 'name' cannot be started 
with access (UT) because it contains the active resource limit 
specification table. If the database must be started with access 
(UT), then the Resource Limit Specification Table must either be 
stopped (STOP RLIMIT) or switched to use a resource limit 
specification table which is not in the database (START 
RLIMIT,ID = xx). 


DSNT722l TABLESPACE name CANNOT BE STARTED WITH 


ACCESS (UT). IT CONTAINS THE ACTIVE 
RESOURCE LIMIT SPECIFICATION TABLE. 


Explanation: The table space specified in the message cannot 
be started with access (UT) because it contains the active 
Resource Limit Specification Table. 


[ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNTDCST 


eee End of Internal DB2 Information eee 


System Action: The START DATABASE command is ignored. 


User Response: See Operator Response. 


Operator Response: TABLESPACE 'name' cannot be started 
with access (UT) because it contains the active resource limit 
specification table. {f the table space must be started with 
access (UT), then the Resource Limit Facility must either be 
stopped (STOP RLIMIT) or switched to use a resource limit 
specification table which is not in the table space (START 
RLIMIT,ID = xx). 


DSNT723i INDEXSPACE name CANNOT BE STARTED WITH 


ACCESS (UT). IT IS DEFINED ON THE ACTIVE 
RESOURCE LIMIT SPECIFICATION TABLE. 


Exptianation: The index space specified in the message cannot 
be started with access (UT) because it contains the active 
Resource Limit Specification Table. 


| 7 Internal DB2 Information 
This message is issued by the fotlowing CSECT(s): DSNTDCST 


bees =o End of Internal DB2 Information S| 


System Action: The START DATABASE command is ignored. 
User Response: See Operator Response. 


Operator Response: INDEXSPACE 'name' cannot be started 
with access (UT) because it contains the active resource limit 
specification table. If the index space must be started with 








DSNT723! — DSNT726l 


access (UT), then the Resource Limit Facility must either be 
stopped (STOP RLIMIT) or switched to use a different resource 
limit specification table (START RLIMIT,ID = xx). 


DSNT7261 DATABASE name AND ANY SPACE IT CONTAINS 
CANNOT BE STARTED WITH ACCESS (UT). ITIS 


THE ACTIVE COMMUNICATIONS DATABASE. 


Explanation: The database specified in the message cannot be 
started with access (UT) because it is the active Communi- 
cations Database. Furthermore, spaces within the active Com- 
munications Database cannot be started with access (UT). 


[ Internal DB2 Information ~~ ] 
This message is issued by the following CSECT(s): DSNTDCST 
| snd of internal DB2 Information ___ 


System Action: The START DATABASE command is ignored. 
User Response: See Operator Response. 


Operator Response: The named database cannot be started 
with access (UT) because it is the communications database. 
Nor can any spaces contained in the database be started with 
access (UT). If the database or any space within it must be 
started with access (UT), then the distributed data facility must 
be stopped (STOP DDF). 
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Utilities Messages (DSNU...) 


Utilities Message Severity 
Codes 


The severity values shown for the utility messages 
that follow is returned as the job-step condition 
code from the job-step during which the message 
is issued. If additional messages having higher 
severity values are issued during the same job- 
step, the higher value is reflected as the job-step 
condition code. 


Severity values have the following meanings: 


No error occurred 

A condition was 
detected; the user might 
need to take further 
action 

An error was detected 
and processing could 
not continue 


0 Informational 
4 Warning 


8 Error 


DSNU000I csect-name OUTPUT START FOR UTILITY, UTILID 


Explanation: This message marks the start of output for the 
given utility job. The utility ID used to identify the utility job is 
‘uuuuuuu'. 


| internal DB2 Information | 


This message is issued by the foilowing CSECT(s): 
DSNUGBAC, DSNUGSDA, DSNUGUTC 


be ee End of Internal DB2 Information free et ol 


Severity: 0 (informational) 


System Action: Utility processing continues. 


DSNUO0SI 


Explanation: This message displays the utility statements as 
they were provided as input to the utility parser. An additional 
error message follows this message and identifies why the 
utility statement caused a parser error. 


csect-name input record 


Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUGPRS, 
DSNUGTIS 


Le es End of Interna! DB2 Information Saree: 


Severity: 8 (error) 


DSNUO00! — DSNUOODSI 


System Action: Utility processing is not initiated. No 
SYSIBM.SYSUTIL record is created. 


User Response: Correct the input error, and resubmit the job. 
Do not restart the job. 


DSNUOO61 csect-name DB2 SYSTEM system-name HAS NOT 


BEEN STARTED 


Explanation: Utility startup processing has been unable to 
connect to the indicated DB2 subsystem, because a -START 
DB2 command has not been issued for that subsystem. 


Severity: 8 (error) 


System Action: Utility processing is terminated without 
invoking the requested utility or utilities. 


User Response: Correct your JCL to specify the correct 
subsystem-name on the EXEC card, and resubmit the job. Oth- 
erwise, contact the system programmer to determine when the 
subsystem will be available for processing. 


Operator Response: Contact the system programmer to deter- 
mine if a-START DB2 command should be issued for the indi- 
cated subsystem. 


System Programmer Response: Have the operator issue a 
-START DB2 command for the indicated subsystem. 


Problem Determination: DB2 must be started in order to 
execute DB2 utilities. 


DSNUO0O07I csect-name DB2 SYSTEM system-name DOES 


NOT EXIST 


Explanation: Utility startup processing has been unable to 
connect to the indicated DB2 subsystem, because it does not 
exist on this system. 


Severity: 8 (error) 


System Action: Utility processing is terminated without 
invoking the requested utility or utilities. 


User Response: Correct your JCL to specify the correct 
subsystem-name on the EXEC card, and resubmit the job. 
Contact your system programmer if you are not sure which DB2 
subsystem you should specify. 


System Programmer Response: Ensure that the correct DB2 
subsystem has been started via the -START DB2 command. 


Problem Determination: DB2 must be started in order to 
execute DB2 utilities. 


DSNU008! ~=csect-name SPECIFIED USER FAILED VALIDITY 


CHECK 


Explanation: Utility startup processing has been unable to 
connect to DB2, because the user failed the connection validity 
check. 


Severity: 8 (error) 


System Action: Utility processing is terminated without 
invoking the requested utility or utilities. 


User Response: Contact the system programmer for assist- 
ance with your installation’s security checking. 


System Programmer Response: Locally defined RACF or 
equivalent security system connection authorization have 
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DSNUOOSI — DSNUOT5I 


denied the user access to DB2. Permit DB2 connection authori- 
zation if this user should be allowed access. 


DSNUO009I csect-name SPECIFIED USER NOT AUTHORIZED 


FOR DB2 UTILITIES 


Explanation: Utility startup processing for the user indicated 
on the job card has failed, because the user is not authorized to 
execute DB2 utilities. 


Cs internal DB2 Information i aas, 
This message is issued by the following CSECT(s): DSNUGUTC 


= End of Internal DB2 Information ees 


Severity: 8 (error) 
System Action: Utility processing is terminated without 
invoking the requested utility or utilities. 


User Response: Contact your system programmer for assist- 
ance with your installation’s security checking. 


System Programmer Response: [f the USER specified some- 
thing on the job card that is incorrect, correct it, and resubmit 
the job. Use the SQL GRANT command to give the user the 
desired authority. 


DSNUO10I ~=csect-name UTILITY EXECUTION COMPLETE, 


HIGHEST RETURN CODE = rr 


Explanation: The utility completed processing with a return 
code of 'rr'. This indicates that no terminating error was 
detected. 


i Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGBAC 


es a End of Internal DB2 Information a ee 


Severity: 0 (informational) or 4 (warning) 


System Action: In most cases, the SYSIBM.SYSUTIL record for 
this job-step is deleted from SYSIBM.SYSUTIL. However, if the 
utility used was REORG and UNLOAD(PAUSE), the 
SYSIBM.SYSUTIL record remains intact so that REORG can be 
restarted at the RELOAD phase. 


User Response: lf the return code ('rr') is 0, no response is 
required. 


lf the return code ('rr') is 4, the utility output should be exam- 
ined for other messages. 


DSNU012I ~=csect-name UTILITY EXECUTION TERMINATED, 


HIGHEST RETURN CODE = rr 


Explanation: The utility execution was terminated. An error 
was detected that would not allow processing to continue. The 
return code has a value of 8. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUGBAC 


| Ss End of Internal DB2 Information | 
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Severity: 8 (error) 
System Action: Utility processing is terminated. 


User Response: Examine utility output for other error mes- 
sages. 


DSNU0131 = csect-name JOB WITH DUPLICATE UTILID FOUND 


IN SYSUTIL 


Explanation: An entry with the same qualifier was found in the 
SYSIBM.SYSUTIL table. The current job did not specify restart. 


| Internal DB2 Information — > 
This message is issued by the following CSECT(s): DSNUGUTC 


Saas End of Internal DB2 Information | 


Severity: 8 (error) 
System Action: The utility job is terminated. 


User Response: If the job was intended to restart the utility, 
RESTART should be added to the EXEC parameters. If the job 
was intended to rerun the utility, the -TERM utility command 
should be used to delete the entry that has the same qualifier 
from the SYSIBM.SYSUTIL table. If the job had no relation to 
the SYSIBM.SYSUTIL entry job, a new qualifier should be used. 


DSNU014I ~—csect-name JOB WITH DUPLICATE UTILID CUR- 


RENTLY EXECUTING 


Explanation: A job with the same qualifier was found to be 
executing. 


[ Internal DB2 Information ~~~ 
This message is issued by the following CSECT(s): DSNUGUTC 


Lo End of Internal DB2 Information eer 


Severity: 8 (error) 
System Action: Utility processing’is not initiated. 


User Response: if the job with the same qualifier that is cur- 
rently executing is correct, either wait for the job to complete 
before using the same qualifier, or use another qualifier. If the 
job currently executing is incorrect, the -TERM command can 
be used to terminate it, and the failing job can be resubmitted. 
Do not -TERM UTILITY a utility job-step that is currently active 
in REORG beyond the UNLOAD phase. 


DSNUO015i_ _csect-name JOB WITH UTILID NOT FOUND IN 


SYSUTIL FOR RESTART 


Explanation: A utility job was submitted to restart a utility job 
that had previously failed. The SYSIBM.SYSUTIL entry for the 
specified qualifier provided was not found. 


i. Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGUTC 


(ey cet End of Interna! DB2 Information eee 


Severity: 8 (error) 


System Action: Utility processing is not initiated. 


User Response: Use the -DISPLAY utility command to deter- 
mine the correct qualifier. The job can then be resubmitted. 


csect-name UTILITY BATCH MEMORY EXE- 
CUTION ABENDED, REASON = XOrrr 


DSNU016I 


Explanation: The utility batch address space has abended. If 
X'Orrr' is four characters in length (that is, X'00Ct'), the abend 
was a system X'rrr' abend. If X'Orrr' is four characters in 
length and system abend X'000' was indicated, a user abend 
was issued. If X'Orrr' is eight characters in length, the abend 
was a system X'04E' abend, and X'Orrr' is an abend reason 
code. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUGBAC 


[Peat onan End of Internal DB2 Information ee 


System Action: The utility job is abended. The 
SYSIBM.SYSUTIL entry for the job is retained in the SYSUTIL 
table. 


User Response: Consult the system programmer to obtain 
information on failure analysis. If the cause of the failure is cor- 
rectable, the utility job can be restarted. If the error cannot be 
corrected, the -TERM command should be used to delete the 
failing job’s utility id from SYSIBM.SYSUTIL. 


System Programmer Response: if a system abend was 
encountered (4 characters), refer to the appropriate MVS publi- 
cation. If an abend reason code was encountered (8 charac- 
ters), refer to Chapter 3 of Command and Utility Reference for 
problem determination. 


DSNU017I_ csect-name UTILITY DATABASE SERVICES 
MEMORY EXECUTION 


ABENDED, REASON = XOrrr 


Explanation: The database services address space has 
abended. If X'Orrr' is four hexadecimal digits in length (for 
example, X'00C1'), the abend was an MVS X'rrr' abend. if 
X'Orrr' is eight hexadecimal digits in length, the abend was a 
DB2 subsystem X'04E' abend, and X'Orrr' is an abend reason 
code. 


= Internal DB2 Information a | 
This message is issued by the following CSECT(s): DSNUGBAC 


eee End of Internal DB2 Information eS 


System Action: The utility job is abended. The entry for the job 
is retained in the SYSIBM.SYSUTIL table. 


User Response: Consult with the system programmer to obtain 
information about failure analysis. If the cause of the failure is 
correctable, the utility job can be restarted. If the error cannot 
be corrected, the -TERM command should be used to delete the 
failing job’s utility id from SYSIBM.SYSUTIL. 


System Programmer Response: If an MVS system abend was 
encountered (4 hexadecimal digits), refer to the appropriate 
MVS publication. If an abend reason code was encountered (8 
hexadecimal digits), look up the reason code in “Section 4. DB2 


DSNU016I — DSNU028I 


Codes” on page 4-1, and refer to Section 5 of Diagnosis Guide 
and Reference for failure analysis procedures. 


DSNUO201_ ~=csect-name JOB STEP INCOMPLETE 


Explanation: The REORG utility was invoked with the UNLOAD 
PAUSE option. This causes the immediate suspension of the 
job after the unload phase completes. Subsequent utilities that 
are invoked in the same job-step are not run. 


fo - oe Internal OB2 Information Spe ee 
This message is issued by the following CSECT(s): DSNUGUTC 


[ice ne Seles End of Internal DB2 Information feet eto 


Severity: 4 (warning) 
System Action: Further utility processing is terminated. 


User Response: Resubmit the job with the RESTART(PHASE) 
parameter after the desired user action has been taken with 
the unload data set. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference for a description of the REORG utility and the 
UNLOAD PAUSE option. i 


DSNU0241 csect-name PARM FIELD ERROR parm-field 


Explanation: An error was detected in the PARM field from the 
EXEC card. 'parm-field' was the input parameter field. 


ras internal DB2 Information eee 
This message is issued by the following CSECT(s): DSNUGBAC 


Re eee End of Interna! DB2 Information een ee 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Correct the indicated parameter on the EXEC 
DD statement,.and resubmit the job. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference for parameter requirements. 


DSNU028i csect-name UNABLE TO CONNECT TO DB2, 


REASON = Xreason code 


Explanation: A connection to the DB2 subsystem failed. 
‘reason-code' is the DB2 reason code that was returned. 


eo Internal DB2 Information ie a aaa | 
This message is issued by the following CSECT(s): DSNUGBAC 


[et eat tees End of internal DB2 information feet 


Severity: 8 (error) 
System Action: The utility job is terminated. 


User Response: Check the subsystem ID specified in the EXEC 
DD card. If it is correct, the subsystem was not ready for proc- 
essing. Ask the system programmer when the requested sub- 
system wil! again be available for processing. 
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DSNU030I — DSNUOSSI 


DSNU030I ~=scsect-ename UNABLE TO ALLOCATE dsn, RC=rr, 


REASON =ccc 


Explanation: The utility was unable to allocate a necessary 
image copy data set. ‘dsn' is the data set name that the utility 
attempted to dynamically allocate. ‘rr' is the return code from 
the MVS dynamic allocation service, and 'ccc' is the reason 
code associated with the return code. 


| Internal DB2 Information a | 


This message is issued by the following CSECT(s): DSNUCRVO, 
DSNUBCLO 


| End of Internal DB2 Information 


System Action: The utility proceeds along one or the following 
paths: 


If the data set was an incremental image copy data set, the 
utility proceeds as if it and any later incremental image copies 
did not exist. 


If the data set was a full image copy data set, the utility attempts 
to use the most recent prior full image copy data set. 


The allocation failure may create other problems that will cause 
the utility to fail. This is indicated by other messages. 


User Response: If the job fails, contact the system pro- 
grammer. 


System Programmer Response: If the utility fails because of 
the allocation error (as shown by a subsequent message), 
correct the error, then resubmit the job. 


Problem Determination: Refer to the appropriate MVS publica- 
tion for a complete description of the possible return and 
reason codes from dynamic allocation. 


DSNU0311 = csect-name UNABLE TO UNALLOCATE dsn, 


RC=rr, REASON =ccc 


Explanation: The recover utility was unable to unaliocate an 
image copy data set. The data set name that the utility 
attempted to unallocate is 'dsn'. The return code from the 
MVS dynamic unallocation service is 'rr'. The reason code 
associated with the return code is ‘ccc’. 


| Internal DB2 Information a | 


This message is issued by the following CSECT(s): DSNUBCLO, 
DSNUBCL5 


| _s End of Internat DB2 Information _____——_—t 


System Action: The unallocation error is ignored and the utility 
execution continues. 


Probiem Determination: Refer to MVS/XA System Program- 
ming Library: Supervisor Services and Macro Instructions for a 
complete description of the possible return and reason codes 
from dynamic allocation. 
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DSNU032E I/O ERROR ON WORKFILE, xxxxxx 


Explanation: An |/O error was encountered on a necessary 
OS/VS data set. 'xxxxxx' is a message that describes the error 
and the data set in error. This message is returned to the DB2 
utility by SVC 68 (SYNADAF) from BSAM. The data set may 
have been needed for an unload data set, image copy data set, 
or load or reorganization work file data set. The utility is 
stopped at the beginning of the phase that used the OS/VS data 
set. 


[ ; ” ~~ Internal DB2 Information SSP ee ey 
This message is issued by the following CSECT(s): DSNUGSDA 


Metta to End of Internal DB2 Information eee 


System Action: The utility job is abended with a reason code of 
X'00E40071'. The utility job-step is in the stopped state. 


Operator Response: Except in the case of an unload data set 
during the RELOAD phase, the job can be restarted if an 
undamaged output data set is provided. 


Problem Determination: Refer to the appropriate MVS publica- 
tion for the format of the error message. 


DSNU034I DATA SET TYPE INVALID FOR DDONAME . 


‘dddddddd' 


Explanation: A required DD card with DDNAME = 'dddddddd' 
was found to have a data set type which is not valid for this 
application. 


| ~~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNURILD, 
DSNURULD, DSNUKDIN 


bee End of internal DB2 Information pe | 


Severity: 8 (error) 
System Action: The utility is terminated with a return code 8. 


User Response: The data set must be capable of storing inter- 
mediate data that can be retrieved by DB2. Check that the data 
set is not specified as type DUMMY, SYSIN, or SYSOUT. If you 
require assistance in specifying a valid data set type, consult 
the system programmer. 


System Programmer Response: Correct the JCL and resubmit 
the job. 


DSNUO35I _csect-name UNABLE TO FIND DD CARD FOR 


DDNAME, 'dddddddd' 


Explanation: A DD card with ddname = 'dddddddd' was 
expected, but not found. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNURILD, 
DSNURULD, DSNUCRIX, DSNUKDIN 


eee ee End of Interna! DB2 Information atone etd 


Severity: 8 (error) 


System Action: The utility is terminated with a return code 8. 


| 
| 


User Response: Ifthe DDNAME is one you submitted, review 
and correct it. If the DDNAME was not provided by you, but by 
the system, consult the system programmer. 


System Programmer Response: Correct the JCL and resubmit 
the job. 


csect-name UNABLE TO OPEN DCB FOR DDNAME 
dddddddd 


Explanation: The DCB associated with DDNAME 'dddddddd' 
could not be opened. 


DSNUO36I 


| Interna! DB2 Information 
This message is issued by the following CSECT(s): DSNUGSDA 


a ea tet End of Internal DB2 Information eae | 


System Action: The utility job is abended with a reason code of 
X'00E40070'. The utility job-step is in the stopped state. 


User Response: If the ddname is one you submitted, review 
and correct it. If the ddname was not provided by you but by 
the system, consult the system programmer. 


System Programmer Response: Correct the job control lan- 
guage and resubmit the job. 


DSNU037I 


Explanation: A data set to be used by the utility has an unde- 
fined record format (RECFM=VU). All data sets must be fixed or 
variable, blocked or unblocked. 


csect-name - RECFM = U FOR DDNAME dddddddd 


| ——«sSInternal DB2 Information ~——_——————S~—S 
This message is issued by the following CSECT(s): DSNUGSDA 


ene eess End of Internal DB2 Information eee hl 


System Action: The utility job is abended with a reason code of 
X'00E40072'. The utility job-step is in the stopped state. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Ensure that no data sets 
involved in the utility job have RECFM=U. Resubmit the job 
after -TERMing the stopped utility, or do a RESTART(PHASE) of 
the stopped utility. 


DSNUO38I_ ~—s csect-name BLOCK SIZE FOR DCB, DDNAME 


dddddddd, IS TOO SMALL, MUST BE AT LEAST 
bbbbb BYTES 


Explanation: The data set with DDNAME 'dddddddd' has a 
block size that is too small to accommodate a record that needs 
to be written. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUGSDA 


Peat eo End of Internal DB2 Information eer ee 


System Action: The utility job is abended with a reason code of 
X'00E40079'. The utility job-step is left in the stopped state. 
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User Response: Delete the data set in error. Change the JCL 
so that the block size for the data set with DDNAME '‘dddddddd' 
is at least 'bbbbb' bytes. Resubmit the utility job with the 
RESTART(PHASE) option. 


DSNUO40I_~=—s csect-name ERROR ACCESSING DDNAME 


ddname, DECB = Xhex string 


Explanation: An error has occurred during BSAM access of a 
utility temporary file identified by 'ddname'. The DECB indi- 
cating the error is given as a hexadecimal string. 


| Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNUGSDA 


| End of Internal DB2 Information | 


System Action: The executing utility issues an X'04E' abend 
with abend reason code '00E40071' following this message. 


User Response: Refer to the information given in the Problem 
Determination section of this message. Correct the problem. 
Either issue the -TERM command to terminate the utility job and 
resubmit it, or specify the RESTART parameter and resubmit it. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


Problem Determination: The DECB provided contains the ECB 
in the first four bytes. The first byte of the ECB contains status 
bits that indicate the cause of the error. Refer to the appro- 
priate MVS publication for the meaning of the status bits. 


DSNU0421_ _csect-name SORT PHASE STATISTICS. NUMBER 


OF RECORDS =n 
ELAPSED TIME = hh/mmi/ss 


Explanation: This message provides statistics on the SORT 
phase of a utility. The number of records sorted, 'n', and the 
duration of the SORT phase in hours, minutes, and seconds are 
provided. 


Internal DB2 information oe ee eee FT 
This message is issued by the following CSECT(s): DSNUGSOR 


| sEnd of Internal DB2 Information ___———_| 


Severity: 0 (informational) 


System Action: The system continues to process normally. 


DSNU0441 ~=csect-name ERROR FROM SORT COMPONENT 


RC =n, UTILITY STOPPED 


Explanation: A non-zero return code 'n' was returned from an 
MVS sort. Error messages from sort are printed on the 
UTPRINT data set. 


ae Internal DB2 Information od 
This message is issued by the following CSECT(s): DSNUGSOR 


[End of Internal DB2 Information 


System Action: The executing utility job is placed in the 
stopped state. 


DB2 Messages 3-159 


DSNUO046I — DSNUOS51I 


User Response: Determine the cause of the error. If the error 
can be corrected, the utility may be restarted from the begin- 
ning of the sort phase by using the RESTART(PHASE) option. If 
the error is such that the utility cannot complete, the -TERM 
command should be issued to remove the stopped utility from 
the system. The -TERM utility option should rarely be exercised 
when the stopped utility is REORG. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


Problem Determination: This abend is accompanied by abend 
reason code X'00E40005', and an SVC dump is requested. In 
most cases, error messages from MVS sort identify the problem 
and the dump is not needed. /f sort is unable to open the 
UTPRINT data set, only the message and the abend are pro- 
vided. For example, if the UTPRINT DD card is omitted, correct 
the problem with UTPRINT, and resubmit the job. 


DSNUO46I ~—=ecsect-name UTILITY STATEMENT IS TOO LONG 


OR TOO COMPLEX 


Explanation: The utility command and associated control state- 
ments have caused the utility statements control block (USM) to 
exceed 32768 bytes of contiguous storage. This exceeds the 
DB2 subsystem limits. 


| = Internal DB2 Information 0 
This message is issued by the following CSECT(s): DSNUGDFL 


eer ae End of Internal DB2 Information ee Se] 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Reduce the size or complexity of the utility 
statement where possible. For example, a LOAD into several 
tables may be broken up into a separate load statement for 
each table or the size of comparison fields for 'when', 
‘continueif', and 'nullif' operands may be reduced in size. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference for correct operand definitions. 


DSNU047I_ ~—s csect-name A REQUIRED DD CARD IS MISSING 


DDNAME = missing-ddname 


Explanation: The DB2 utility being executed requires a data set 
to continue processing. The DDNAME for the missing data set 
is provided. 


‘eZ —e ~~~ _ Internal DB2 Information ~—————— | 
This message is issued by the following CSECT(s): DSNUGSOR 


[| End of Internal DB2 Information ______——_— 


Severity: 8 (error) 

System Action: Utility processing terminates. 

User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Correct the JCL to include the 
indicated DD card. Refer to Chapter 3 of Command and Utility 
Reference for information about required DD cards. 
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DSNU048I ~=—s csect-name INVALID OPERAND FOR KEYWORD 


kkkkkkkk 


Explanation: The utility parser has determined that the 
operand specified for keyword ‘kkkkkkkk' is invalid. 


| ~~ Internal DB2 information ~~ re | 


This message is issued by the following CSECT(s): DSNUGDEFL, 
DSNUGPRS 


[| End of Internal DB2 Information ________| 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Correct the operand in error, and resubmit 
the utility job. Refer to Chapter 3 of Command and Utility Refer- 
ence for correct operand definitions. 


DSNUO0491_—s cseect-name INVALID OPERAND ocoocoooo FOR 


KEYWORD kkkkkkkk 


Explanation: The utility parser has determined that operand 
‘oo0000000' cannot be specified for keyword 'kkkkkkkk'. 


—_— ~~ Internal DB2 Information ~— a ee | 


This message is issued by the following CSECT(s): 


DSNUBCLO DSNUBICO DSNUGDFL 
DSNUGPRS DSNUGPRT DSNUGPRU 
DSNUGPRZ 


[neice se End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Correct the operand in error, and resubmit 
the utility job. Refer to Chapter 3 of Command and Utility Refer- 
ence for proper option specifications. 


DSNUO50!_ _—=sccsect-name utility-statement 


Explanation: This message echoes the utility statement that 
was input from SYSIN. 


SS re Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUGDFL, 
DSNUGUTC 


eee End of Internal DB2 Information ie a 


Severity: 0 (informational) 


System Action: Utility processing continues. 


DSNU051i ~=csect-name INSUFFICIENT OPERANDS FOR 


KEYWORD kkkkkkkk 


Explanation: An operand that is required when the keyword 
‘kkkkkkkk' is specified was omitted. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSNUBCLO DSNUBICO DSNUGDFL 
DSNUGPRS 


[eres ec End of Internal DB2 Information eee el 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Correct the operand specification, and 
resubmit the job. Refer to Chapter 3 of Command and Utility 
Reference to determine the correct set of operands for 
‘kkkkkkkk'. 


DSNU0521 csect-name KEYWORD kkk INCOMPATIBLE WITH 


OTHER KEYWORDS OR OPERANDS 


Explanation: The specified keyword 'kkk' cannot be used with 
other keywords or operands. 


internal DB2 Information a4 
This message is issued by the following CSECT(s): DSNUGDFL 


Wh tes eat, End of Internal DB2 Information Seer 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Refer to the Chapter 3 of Command and Utility 
Reference for the right syntax for the specified keyword. 


DSNUO531 csect-name FIELD cccccccc NOT FOUND 


Explanation: Either the column name specified, 'cccccccc', 
was not found in the catalog as a valid column name for the 
table being processed, or a WHEN keyword field name was not 
found in the field name list. 


| Internal DB2 Information Pe eR aa | 


This message is issued by the following CSECT(s): DSNURPNL, 
DSNURPWN, DSNURWHN 


ieee es End of Internal DB2 Information pete eee nts 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Correct the LOAD utility statement, and 
resubmit the job. 


Problem Determination: Valid column names can be found in 
the SYSIBM.SYSCOLUMNS table. 


DSNU0541 csect-name TABLESPACE ssssssss NOT FOUND 


Explanation: The operand of the TABLESPACE keyword, 
'ssssssss', did not specify an existing table space name. 


DSNU0521 — DSNUOS58I 


(ret ae on Internal DB2 information ae = 
This message is issued by the following CSECT(s): DSNUGMAP 


aa End of Internal DB2 Information dd 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response; Correct the table space name and/or data- 
base name, and resubmit the job. 


Problem Determination: Valid table space names can be found 
in the SYSIBM.SYSTABLESPACE catalog table. 


DSNUO55I_ ~—s csect-name INDEX iiiiiiii NOT FOUND 


oo. Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNUGMAP 


Ba aston End of Internal DB2 Information eee ee al 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 
User Response: Correct the index name, and resubmit the job. 


Problem Determination: Valid index names can be found in the 
SYSIBM.SYSINDEXES catalog tabie. 


DSNUO056! csect-name TABLE titttttt NOT FOUND 


Explanation: The operand of the TABLE keyword, 'tttttttt', did 
not specify an existing table name. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGMAP 


oer End of Internal DB2 Information ee ee, 


Severity: 8 (error) 


System Action: The error is sufficient to terminate further proc- 
essing of the utility job-step. The utility job-step is terminated, 
and resources are released to their prior state. 


User Response: Correct the table name and/or database 
name, and resubmit the utility job-step. 


Problem Determination: The correct table names can be found 
by querying the SYSIBM.SYSTABLES catalog table. 


DSNUO58I_ _—s csecct-name utility-name UTILITY NOT ALLOWED 
AGAINST AN OBJECT IN RECOVERY PENDING 


STATE 


Explanation: An attempt has been made to execute a utility 
against an object that is in RECOVERY PENDING STATE. 
CHECK, COPY, MODIFY, LOAD, QUIESCE, REORG, and 
RUNSTAT are not allowed. 
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DSNUO60!I — DSNUO6SI 


ec — Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSNUGSRI DSNUKINP DSNURWES 
DSNUSDKA 


Diag End of internal DB2 information eel 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Remove the object from the RECOVERY 
PENDING STATE by using either LOAD REPLACE, RECOVER, or 
REPAIR against the object. Resubmit the job. 


System Programmer Response: Determine which of the three 
utilities, LOAD REPLACE, RECOVER, or REPAIR, should be 
used to remove the object from the RECOVERY PENDING 
STATE. 


DSNUOGOI csect-name USER userid NOT AUTHORIZED FOR 


util-name UTILITY ON DATABASE dbase-name 


Explanation: User ‘authorization ID' attempted to execute 
utility ‘util-name' against an object in database 'dbase-name'. 
The user was either not authorized to execute utilities for the 
named database, or the user’s authorization did not include this 
utility. 


r — _ Internal DB2 information =p | 


This message is issued by the following CSECT(s): DSNUGMAP, 
DSNUKINE 


es ‘End of Internal DB2 Information a | 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Ensure that the correct database was speci- 
fied. If the specification is correct, consult the system pro- 
grammer concerning authorization. 


System Programmer Response: Determine why the user was 
denied access. Either the authorization should be corrected, or 
another authorized user should invoke the utility. 


Problem Determination: The following catalog tables can be 
examined to determine who has proper authority: 
SYSIBM.SYSUSERAUTH, SYSIBM.SYSDBAUTH, or 
SYSIBM.SYSRESAUTH. 


DSNUO61I csect-name USER userid NOT AUTHORIZED, 


UTILID = utilid 


Explanation: The user ' authorization !D' has issued a utility 
command and was not authorized to do so. Any user can issue 
the -DISPLAY UTILITY, but only the submitter of the job to be 
displayed, SYSADM and SYSOPR, can issue the -TERM 
UTILITY. 
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[ —_ Internal DB2 Information = 
This message is issued by the following CSECT(s): DSNUGDIS 


{| End of Internal DB2 Information 


System Action: The -DISPLAY UTILITY or -TERM UTILITY 
request is denied. 


User Response: Either obtain the required authorization and 
reissue the command, or have another user with proper author- 
ization issue it. 


csect-name UTILITY MAY NOT BE RUN ON 
OBJECT qualifier.object-name 


DSNU062I 


Explanation: An attempt was made to execute a utility against 
table space DSNDB04.SYSDEFLT or index SYSIBM.SYSDEFLT. 
These two DB2 objects cannot be processed by DB2 utilities. 


| Internal DB2 Information es eo “| 
This message is issued by the following CSECT(s): DSNUGMAP 


oe eee ad End of Internal DB2 Information | 


Severity: 8 (error) 
System Action: The utility job is terminated. 


User Response: Remove the invalid utility contro! statement(s) 
and resubmit the job. 


DSNU064!_ _—scsect-name UTILITY NOT ALLOWED AGAINST 


SYSTEM DATABASE 


Explanation: An attempt has been made to execute a utility 
against database DSNDBO1 or DSNDBO6. The LOAD and 
REORG utilities are not allowed against system databases. 


[ : ; Internal DB2 Information ~~ ——_————— = 
This message is issued by the following CSECT(s): DSNUGMAP 


bee ee End of Internal DB2 Information pa Sl 


Severity: 8 (error) 
System Action: Execution of the utility job is stopped. 


User Response: Remove the invalid utility control statement(s) 
and resubmit the job. 


csect-name UTILITY NOT ALLOWED AGAINST A 
WORK FILE 


DSNUO6S5I 


Explanation: An attempt has been made to execute a utility 
against database DSNDB07. Utilities are not allowed against 
work files. 


[ ee Internal DB2 Information ~~ == | 
This message is issued by the following CSECT(s): DSNUGMAP 


Ph ee tas End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: Execution of the utility job is stopped. 


User Response: Remove the invalid utility control statement(s) 
and resubmit the job. 


DSNUO70I = csect-name KEYWORD OR OPERAND x INVALID 


WITH y 


Explanation: The use of KEYWORD or OPERAND 'x' is incon- 
sistent with KEYWORD or OPERAND 'y'. 


[ Internal DB2 Information ~~ 


This message is issued by the following CSECT(s): DSNUGDFL, 
DSNUGPRS, DSNUGPRU, DSNUGPSP 


es End of Internal DB2 Information re | 


Severity: 0 (informational) 


System Action: The control statement in error is rejected and 
processing is halted. 


User Response: Correct the control statement in error and 
resubmit the job. 


DSNUO71I1 = csect-name KEYWORD x REQUIRES KEYWORD y 


Explanation: When keyword 'x' is specified, keyword 'y' must 
also be specified. 


Internal DB2 Information ~~~ =| 


This message is issued by the following CSECT(s): DSNUGDFL, 
DSNUGPRS, DSNUGPSP 


(eee End of Internal DB2 Information feet rat a 


Severity: 0 (informational) 


System Action: The control statement in error is rejected and 
processing is halted. 


User Response: Correct the control statement in error, and 
resubmit the job. 


DSNU072i ~—s csect-name INVALID KEYWORD(S) SPECIFIED 


FOR TABLESPACE LIST 


Explanation: The specified keyword cannot be included in a 
list.of table spaces. 


fre ee internal DB2 Information ee = L 
This message is issued by the following CSECT(s): DSNUGDFL 


eee End of internal DB2 Information peereeees| 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Remove the specified keyword from the list of 
table spaces. 


DSNU073! 


Explanation: The keyword, 'wwwww' is no longer supported. 


csect-name - KEYWORD 'wwwww' IGNORED 


DSNUO70I — DSNU082! 


ene 35 Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGUTC 


[eee esate End of Internal DB2 Information ea 


Severity: 0 (informational) 
System Action: Utility processing proceeds. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference for the current syntax. 


DSNUO791_ csect-name UNBALANCED PARENS IN CONTROL 


STATEMENT 


Explanation: The utility parser has determined that there is an 
unbalanced parenthesis in the input string. 


rT .CttOt™~SOSSS Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNUGTIS 


Wie End of internal DB2 information ee 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Determine the location of the missing paren- 
thesis and insert it. The utility job can then be resubmitted. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference to determine the correct syntax for option 
specification. 


DSNUOS1I csect-name OPERAND 'oooooo0o' EXCEEDS 


KEYWORD '‘kkkkkkkk' MAXIMUM LENGTH 


Explanation: The utility parser has determined that operand 
‘90000000' exceeds the maximum length for keyword 
"kkkkkkkk'. 


a —— {nternal DB2 Information 


This message is issued by the following CSECT(s): DSNUGPRU, 
DSNUGPTC 


[ese te hace End of Internal DB2 Information ei ey 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 
User Response: Correct the operand, and resubmit the job. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference to determine the correct operand specifica- 
tion. 


DSNUO82I 


Explanation: The given keyword was not recognized within the 
context of this control statement. 


csect-name INVALID KEYWORD kkkkkkkk 
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DSNU083! — DSNU087I 


aa —* Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUGPRS, 
DSNUGPRU, DSNUGPSP 


eee one End of Internal DB2 Information pte oes | 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Correct the keyword, and resubmit the job. 


DSNU083!I ~=—scsect-name INVALID HEXADECIMAL OPERAND 


hhhhhhhh 


Explanation: The utility parser has determined that the 
operand 'hhhhhhhh' is invalid as a hexadecimal operand. It 
either contains a character that is not hexadecimal! or has an 
odd number of characters. 


| Internal DB2 Information a 


This message is issued by the following CSECT(s): DSNUGPRU, 
DSNUGTIS 


{oo End of Internal DB2 Information oe eee 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: Correct the keyword, and resubmit the job. 


DSNUO84I 


Explanation: The utility parser has determined that the 
operand 'gggg' is invalid as a hexadecimal operand. The 
graphic operand is either missing one or both of the shift char- 
acters or is not an even number of characters. 


csect-name INVALID GRAPHIC OPERAND gggg 


| Internal DB2 Information ~~ S| 


This message is issued by the following CSECT(s): DSNUGPRU, 
DSNUGTIS 


Maes ee oe End of Internal DB2 Information pap eel 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Correct the utility statement, and resubmit the 
job. 


DSNUO85!I _—scsect-name INVALID SPECIAL CHARACTER 


OPERAND ssss 


Explanation: The utility parser has determined that the 
operand 'ssss' is invalid as a special character operand. For a 
special character operand to be invalid, it must have either a 
shift-out or a shift-in character and be missing the corre- 
sponding shift character, or not have an even number of char- 
acters between the shift-out, shift-in characters. 
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| Internal DB2 Information z | 
This message is issued by the following CSECT(s): DSNUGTIS 


Se End of Internal DB2 Information Tae | 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Correct the utility statement, and resubmit the 
job. 


DSNUO86!I_—s csect-name ttttt I/O ERRORS ON SPACE = 
dddddddd. DATA SET NUMBER= nnn. I/O 


ERROR PAGE RANGE = aaaaaa, bbbbbb. 


Explanation: |/O errors were detected on the named table 
space. 'ttttt' is either 'READ' or 'WRITE'. ‘nnn’ is the data 
set number. ‘aaaaaa' is the first damaged page and 'bbbbbb' 
is the last damaged page of the data set. 


internal DB2 Information | | 
This message is issued by the following CSECT(s): DSNUCDA1 


ih ete End of internal DB2 Information eer 


Severity: 0 (informational) 


System Action: Processing continues, but the pages within the 
error range are no longer accessible. 


System Programmer Response: Determine the appropriate 
level of recovery, and invoke the recovery utility. If user- 
defined data sets are being used and full data set or table 
space RECOVER is to be used, then, prior to invoking the 
RECOVER utility, the table space must be stopped, new data 
set(s) defined, and the table space restarted. 


Problem Determination: Refer to Chapter 2 of Command and 
Utility Reference for a discussion of database recovery proce- 
dures. 


DSNU087I _csect-name INVALID OPERAND TYPE FOR 


KEYWORD kkkkkkkk - c0000000 


Explanation: The utility parser has determined that the 
operand 'ooooooco0' is the wrong type for the keyword 
'kkkkkkkk'. An example of such an error would be a decimal 
operand where only a hexadecimal operand is allowed. 


—— So Internal DB2 Information | 


This message is issued by the following CSECT(s): OSNUGDEFL, 
DSNUGPRS, DSNUGPRU, DSNUGPRW, DSNUGPTS 


[ee nese cat End of Internal DB2 Information te 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 
User Response: Correct the keyword, and resubmit the job. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference to determine valid operand types for the des- 
ignated keyword. 


| 
| 


DSNUO088I_ _—ecsect-name INVALID CHARACTER OPERAND 


eccccccc 


Explanation: The utility parser has determined that the 
operand ‘cccccccc' is invalid as a character operand. 


| ~ Internal DB2 Information ae | 
This message is issued by the following CSECT(s): DSNUGTIS 


[snd of Internal DB2 Information ____——_—d 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 
User Response: Correct the keyword, and resubmit the job. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference for correct specification of the character 
operand. 


DSNUOS89! csect-name OPERAND oooooooo IS TOO LONG 


Explanation: The utility parser has determined that the 
operand 'o0000000' is too long for the keyword specified. 


| Internal DB2 Information SP eet 


This message is issued by the following CSECT(s): DSNUGDFL, 
DSNUGPRZ 


ae End of Internal DB2 Information eee | 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 
User Response: Correct the keyword, and resubmit the job. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference for correct operand length specification. 


DSNUOSOI csect-name DDNAME nnn [IS INVALID FOR 


KEYWORD kkk 


Explanation: The DDNAME 'nnn' was used as an improper 
input of the specified keyword 'kkk' or from one of the reserved 
ddnames: SYSIN, SYSPRINT, UTPRINT, SORTWKnn, SORTLIB. 


[— _—-s Internal DB2 Information —- ye 
This message is issued by the following CSECT(s): DSNUGDFL 


(ee ee eee es End of Internal DB2 Information eae] 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Refer to Section 1 of Diagnosis Guide and Ref- 
erence for all the reserved ddnames and find the proper 
ddname for the specified keyword. 


DSNU0STI 


Explanation: The DDNAME 'nnn' was used as as operand in 
the input statement more than once. 


csect-name DDNAME nnn IS A DUPLICATE 


DSNUO88I — DSNUOQ6I 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGDFL 


ees End of Internal DB2 Information eee A 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Change the ddname to a different one. 





DSNU092!_ ~—s csect-name NUMBER OF OPERANDS FOR 


KEYWORD kkk EXCEEDS MAXIMUM 


Explanation: The keyword 'kkk' contains more than the 
maximum number of operands. 


ir: aetna Internal DB2 Information | 


This message is issued by the following CSECT(s): 
DSNUGPSP DSNUGPR2 


EP ee End of Internal DB2 Information je She ae Ee 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Refer to Chapter 3 of Command and Utility 
Reference for the limit on the number of operands for the speci- 
fied keyword. 


OSNU095I_ =e csect-name UTILITY uwuuuuuu INCONSISTENT 


WITH LAST INVOCATION 


Explanation: This message can occur when a utility job-step is 
restarted and a utility statement has been added or deleted 
from SYSIN. 


a Internal DB2 Information eee 
This message is issued by the following CSECT(s): DSNUGUTC 


bee End of Internal DB2 Information | 


Severity: 8 (error) 


System Action: Utility processing is terminated. The utility job- 
step remains in SYSIBM.SYSUTIL in the stopped state. 


User Response: Restart the utility job with the statements in 
the same order as they were in when the job was first run. 


Problem Determination: Utility statement order should not be 
altered for restart. 


DSNUOSE! csect-name OPERAND oooooooo INCONSISTENT 


WITH LAST INVOCATION 


Explanation: When the utility job-step was restarted, the indi- 
cated operand was found to be inconsistent with the restart 
point. 
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DSNUO991 — DSNU104I 


Internal DB2 Information a | 


This message is issued by the following CSECT(s): 


DSNUCRVA DSNURFIT DSNURWES 
DSNURWET DSNURWIR 


LS séEnd of Internal DB2 Information id 


System Action: The restart of utility processing is not initiated. 


User Response: To restart, restore the operand to its prior 
definition. If this is not acceptable, terminate the utility job- 
step, take corrective action, and resubmit the job. 


Operator Response: An operator with SYSOPR authority can 
terminate the utility job-step (this may not be necessary). A 
REORG utility that is beyond the UNLOAD phase should rarely 
be terminated. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference for operand definitions. Refer to Section 5 
(Volume 2) of Administration Guide for a discussion of utility 
restart constraints. 


DSNUO99!_ _—scsect-name - IRLM 'req-type' REQUEST FAILED, 
IRLM RETURN CODE = X'return-code' IRLM 


REASON CODE = X'reason-code' 


Explanation: A request was sent to the IRLM to either obtain or 
release the utility serialization lock and the request could not 
be performed for the reasons specified in 'return-code' and 
'reason-code'. These are documented in “Section 5. IRLM 
Messages and Codes” on page 5-1. The type of request is indi- 
cated by 'req-type'. 


[oe Internal DB2 Information ~ 


This message is issued by the following CSECT(s): DSNUGDIS, 
DSNUGSRI, DSNUGSRX, DSNUGULA. 


eae See End of Internal DB2 Information oe ere 


System Action: Further utility process is terminated. 


User Response: Refer to the IRLM messages and codes 
section for problem determination and the proper course of 
action. The utility may be restarted by specifying the RESTART 
parameter or the -TERM command may be issued to terminate 
the utility before resubmitting the job. 


System Programmer Response: Determine the cause of the 
IRLM error and take appropriate action. 


Problem Determination: Provide system console log output, 
dump and SYS1.LOGREC information. Refer to Section 5 of 
Diagnosis Guide and Reference for IRLM service aids providing 
additional information. 


DSNU100I csect-name USERID = userid UTILID = utilid 
PROCESSING UTILITY STATEMENT statement- 
number UTILITY = utility-yname PHASE = utility- 
phase COUNT = object-count STATUS = 


STOPPED 


Explanation: This message is issued in response to a prior 
request to display utility status (that is, -DISPLAY UTILITY). It 
indicates that execution of the utility job with the utility identifier 
(UTILID) of 'utilid' has stopped during its execution. At the 
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time of the request, 'object-count' records or pages had been 
processed. If the utility job-step is restarted with the 
RESTART(PHASE) option, it begins with PHASE '‘utility-phase'. 


Not all utilities have phases. Those that do have phases are 
restarted from the beginning. 


The utility has stopped for one of the following reasons: 


¢ The REORG utility stopped in response to its 
UNLOAD(PAUSE) option. The utility is stopped in the 
RELOAD phase. 

¢ The utility is stopped because of some DB2 subsystem 
failure or cancelation (for example, -STOP DB2). 


—. =. 2 Internal DB2 Information oe ad 
This message is issued by the following CSECT(s): DSNUGDIS 


End of Internal DB2 Information eee 


System Action: DB2 is waiting for an explicit external direction 
concerning the disposition of the utility job and its claim upon 
DB2 resources. That direction can be to restart or terminate 
the utility job. 


User Response: Someone with the required authority should 
either restart or terminate the utility job-step. 


To restart the job-step, the person must have authority to 
execute the indicated utility and to complete whatever other 
utility functions are in the identified utility job-step. 


To terminate the utility ("TERM UTILITY), the invoker must be 
the originator or have SYSOPR or SYSADM authority. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


DSNU103I _=csect-name - UNABLE TO ACCESS SYSUTIL 


TABLE AT THIS TIME 


Explanation: A -DISPLAY or -TERMINATE UTILITY command 
was issued at the same time that the SYSUTIL table space was 
the object of a active utility job. The utility job may be holding 
locks that would cause a deadlock condition to occur. 


| internal DB2 Information a | 
This message is issued by the following CSECT(s): DSNUGDIS 


pense se 2 End of Internal DB2 Information ies ee ctl 


Severity: 4 (warning) 
System Action: The command processing is terminated. 


User Response: Enter the command again. This message will 
continue to be received in response to each command until the 
utility action on the SYSUTIL table space has completed. 


DSNU1041 SYSUTIL IN A PENDING STATE PROHIBITS 


FURTHER PROCESSING 


Explanation: The TERM or DISPLAY command was issued 
when SYSUTIL was in a pending state which prohibits further 
processing. The pending state was either copy or recovery 
pending. 


(a ~~~ {nternal DB2 Information ~ | 


This message is issued by the foliowing CSECT(s): DSNUGTER, 
DSNUGDIS 


eee End of internal DB2 information eel 


Severity: 4 (warning) 
System Action: Command processing is terminated. 


User Response: Notify the system programmer so that the 
pending condition can be resolved. 


System Programmer Response: Issue a display database to 
determine the state of SYSUTIL. If in copy pending, do a full 
image copy. If in recovery pending, use the recover utility to 
recover SYSUTIL. 


Refer to Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: Use the display database command to 
determine the state of SYSUTIL. 


DSNU1051 csect-name - USERID = userid UTILID = utilid 
PROCESSING UTILITY STATEMENT n 
UTILITY = utility-type PHASE = phase-name 


COUNT =n STATUS = status 


Explanation: This message is issued in response to a prior 
request to display utility status (-DISPLAY UTILITY). It indicates 
that the 'utility-name’ utility in the utility job-step identified by 
UTILID '‘utilid' was executing in the indicated phase 
‘utility-phase' at the time the -DISPLAY UTILITY request was 
made. 


| ay a “= Internal DB2 Information ~ aa | 
This message is issued by the following CSECT(s): DSNUGDIS 


[| End of Internat DB2 information 


Severity: 0 (informational) 


System Action: The message reflects the state of DB2 at the 
time of the -DISPLAY UTILITY command. The system has con- 
tinued with its processing. A subsequent -DISPLAY UTILITY 
command would reflect that processing. 


This message provides the user with an estimate of how far the 
indicated utility has proceeded in the indicated utility job-step. 


DSNU106I csect-name cccccccc UTILITY, UTILID = uuuu 


TERMINATING 


Explanation: This message is in response to a prior request to 
display utility status (that is, -DISPLAY UTILITY). It indicates 
that the 'cccccccc' UTILITY in the utility job-step identified by 
UTILID 'uuuu' was in the process of terminating at the time the 
-DISPLAY UTILITY request was issued. 


The utility is terminating in response to a prior -TERM UTILITY 
request. 


DSNU105I — DSNU1121 


_-—* Internal DB2 Information a ea 
This message is issued by the following CSECT(s): DSNUGDIS 


_————— End of Internal DB2 Information ee 


Severity: 0 (informational) 


System Action: The system is in the process of stopping the 
indicated utility, releasing all resources associated with the 
utility processing, and removing the indicated UTILID from its 
status tracking mechanism. 


After termination is complete, the UTILID can be reused. 


User Response: The message informs the user that the utility 
job-step identified by UTILID 'uuuu' is being terminated and 
upon completion will no longer be defined to the system. 


It indicates that someone has requested the termination of the 
utility job-step indicated by UTILID 'uuuu'. 


DSNU1101_ —csect-name UTILID = uuuu INVALID 


Explanation: This message is issued in response to an invalid 
specification of either a UTILID on a -DISPLAY UTILITY or a 
-TERM UTILITY command. A UTILID is a 1- to 16-byte alphanu- 
meric token that can contain any number of periods. 


—— = Internal DB2 Information ~~ 
This message is issued by the following CSECT(s): DSNUGCCC 
Ls End of Internal DB2 Information 


System Action: The -DISPLAY UTILITY or -TERM UTILITY 
command is rejected. Further processing of the command is 
ended. 


User Response: Review the UTILID provided in the message to 
determine why it does not conform to the syntax rules of a utility 
identifier token, and reissue the request. 


DSNU1121 csect-name NO AUTHORIZED UTILITY FOUND 


FOR UTILID = uuuu 


Explanation: This message is issued in response to a prior 
-DISPLAY UTILITY or -TERM UTILITY command. Either DB2 has 
no record of the utility job-step identified by the utility identifier 
(that is, UTILID) ‘uuuuu', or the invoker does not possess the 
proper authorization to issue the -TERM UTILITY command. 
Only the originator of the utility job-step or persons with 
SYSOPR or SYSADM authority may terminate its execution. 
Anyone can display its status (-DISPLAY UTILITY). 


i — Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUGCCC, 
DSNUGDIS 


| End of internal DB2 Information 


Severity: 0 (informational) 


System Action: The system rejects the -DISPLAY UTILITY or 
-TERM UTILITY request for the indicated utility job-step. No 
further action is taken. 
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User Response: The user should verify that the UTILID of the 
utility job step intended to be displayed or terminated has been 
correctly entered. If it has, the appropriate system adminis- 
trator should be consulted concerning obtaining proper authori- 
zation for the -TERM UTILITY command. 


Problem Determination: One can issue the -DISPLAY utility 
command to determine if the UTILID is currently known to DB2. 
If it is, the message indicates that the invoker does not have the 
proper authority to terminate the utility job-step. 


DSNU1141 ~—scsect-name UTILITY COMMANDS SUBSYSTEM 


FAILURE, REASON = Xcode 


Explanation: This message indicates an abend has occurred in 
the utility commands subsystem. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGCCC 


ee oe End of Internal DB2 Information _ id 


System Action: The command abnormally terminates. In the 
case of the -TERM command, termination actions taken previ- 
ously under this command are backed out. 


User Response: Prior messages and/or the SVC dump identify 
the failure. If the condition can be corrected, the command may 
be reissued. 


Problem Determination: In most cases, the failure is not user 
related. Refer to Section 5 of Diagnosis Guide and Reference 
for failure analysis procedures. In some cases, prior messages 
indicate a user error that may be corrected. The problem may 
be as simple as SYSIBM.SYSUTIL being temporarily locked by 
another command or a utility job. 


DSNU160I_ _—s csecct-name - utility-name UTILITY, UTILID = utilid 
REQUESTED TO TERMINATE, PHASE = utility- 


phase WAS ACTIVE 


Explanation: This message is issued in response to a -TERM 
UTILITY command. It acknowledges that the request for termi- 
nation was received and verified. At the time the -TERM 
UTILITY request was received, utility 'utility-name' was ACTIVE 
in the utility job-step identified by UTILID ‘utilid'. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGTER 


[oo End of Interna! DB2 Information ee 


System Action: DB2 has accepted the request to terminate the 
indicated utility job-step. The utility terminates at its next 
cleanup point. 


User Response: This message is an acknowledgement that the 
request has been accepted and is in progress. 


DSNU164I csect-name cccccccc UTILITY, UTILID = uuuu 


ALREADY TERMINATING 


Explanation: This message is in response to a -TERM UTILITY 
command. It indicates that the utility job-step indicated by 
UTILID 'uuuuu' has already been requested to terminate and is 
in the process of doing so now. 


3-168 DB2 Messages and Codes 


ss ae oe Internal DB2 Information ia: 
This message is issued by the following CSECT(s): DSNUGTER 


le ro oes End of Internal DB2 Information ee eee 


Severity: 0 (informational) 


System Action: DB2 is currently in the process of terminating 
the indicated utility job-step. Upon completion, all resources 
will have been released to their prior state, and all tracking of 
the indicated UTILID will have been removed. At that point, the 
UTILID is available for reuse. 


User Response: This message indicates that either the request 
was redundant, or someone else is also interested in the termi- 
nation of the subject utility job-step. 


DSNU1661 _ csect-name utility-name UTILITY, UTILID = uid 
NOT EXECUTING, 


CLEANUP COMPLETE 


Explanation: This message is in response to a -TERM UTILITY 
command. The ‘utility-name' utility identified by UTILID 'uid' 
was found to be stopped at the time of the request to terminate. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGTER 


a er End of Internal DB2 Information eee 


Severity: 0 (informational) 


System Action: Cleanup is performed for the indicated stopped 
utility. All resources held by the utility are freed and all storage 
of the utility job is deleted. The utility job is no longer 
restartable. 


System Programmer Response: Resources held by this utility 
may have prevented applications, commands, and other utilities 
from executing. These have been freed, so that the inhibited 
tasks may now be performed. 


DSNU1701_ csect-name UTILITY JOB TERMINATED BY TERM 


COMMAND 


Explanation: A -TERM UTILITY command was issued for this 
utility job-step. 


[fo eae Internal DB2 information ot eG 
This message is issued by the following CSECT(s): DSNUGTCK 


tee End of Internal DB2 Information oi pees sl 


Severity: 8 (error) 


System Action: The executing utility terminates processing and 
frees all held resources. All storage of the utility job has been 
deleted. Therefore, the job is not restartable. Subsequent utili- 
ties in the same job-step are not executed. 


User Response: All or portions of the utility job-step may be 
resubmitted as needed. 


DSNU172I csect-name UTILITY JOB TERMINATED BY STOP 


DB2 COMMAND 


Explanation: A-STOP DB2 command was issued during exe- 
cution of the utility job-step. 


| Interna! DB2 Information | 


This message is issued by the following CSECT(s): DSNUGBAC, 
DSNUGTCK, DSNUGUTC 


Ls End of Internal DB2 information sd 


Severity: 8 (error) 


System Action: The executing utility stops processing but con- 
tinues to hold resources. Subsequent utilities in the same job- 
step are not executed. The storage of the utility job is retained. 
Therefore, the utility job-step is restartable. 


User Response: Following a -START DB2 command, the utility 
job-step may be restarted. Alternatively, the utility may be ter- 
minated using the -TERM UTILITY command and resubmitted as 
a new job. A REORG utility that has passed the UNLOAD phase 
should rarely be terminated. 


DSNU180!1_ _—csect-name utility-name UTILITY NOT COMPAT- 


IBLE WITH utility-name UTILITY, UTILID = uid 


Explanation: Certain utilities cannot be processing the same 
table space at the same time. The message identifies that this 
incompatibility has occurred. 


Ce ——— Internal DB2 Information i 
This message is issued by the following CSECT(s): DSNUGSRI 


| Ss End of Internal DB2 Information 


Severity: 8 (error) 


System Action: The first utility is not initiated, and further utility 
processing in that utility job-step is terminated. 


User Response: Use -DISPLAY UTILITY with the provided 'uid' 
to determine when the utility that caused your utility to be 
rejected is completed. 


Problem Determination: Refer to Section 5 (Volume 2) of 
Administration Guide for a discussion of which utilities are 
mutually compatible. 


DSNU182I ~=csect-name RECOVER SYSUTIL MUST BE THE 


ONLY UTILITY IN SYSIN 


Explanation: The submitted utility contro! statements contain a 
RECOVER of table space SYSIBM.SYSUTIL. This table space is 
integral to controiling the execution of utilities. Control over 
previous or subsequent utilities in the job-step would be lost if 
the RECOVER were allowed to take place. Therefore, 
RECOVER of SYSIBM.SYSUTIL must be the only utility in a job- 
step. 


DSNU1721 — DSNU250! 


| oa Internal DB2 Information ; | 
This message is issued by the following CSECT(s): DSNUGSRI 


Pi cas ees End of Interna! DB2 Information eee | 


Severity: 8 (error) 


System Action: Work performed by utilities in the same utility 
job-step prior to the RECOVER SYSIBM.SYSUTIL persist. The 
RECOVER and subsequent utilities are not allowed to execute, 
and the utility job-step is placed in the stopped state. 


User Response: The utility execution that received this 
message should be terminated using the -TERM UTILITY 
command, and a subsequent job-step should be submitted con- 
taining only RECOVER SYSIBM.SYSUTIL. Additional utilities, if 
any, should be executed in a separate job-step. 


DSNU1831_ _csect-name - utility-name UTILITY NOT COMPAT- 


IBLE WITH OTHER ACTIVE UTILITIES 


Explanation: The utility identified by ‘utility-name' must be 
executed alone. There must not be any other active DB2 utili- 
ties in the system. 


[ee Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNUGSRI 


(ie ee eee End of Interna! DB2 Information rs 


System Action: Utility execution is terminated. 


User Response: Notify the system programmer if necessary. 
Note that an image copy of DSNDB01.SYSUTIL SHRLEVEL (REF- 
ERENCE) must execute alone, while SHRLEVEL (CHANGE) 
allows execution with other active utilities. 


Operator Response: Notify the system programmer. 


System Programmer Response: Run this utility when there are 
no other utilities in the system. 


Problem Determination: The -DISPLAY UTILITY command may 
be used to see what utilities are ACTIVE. Utilities in the 
STOPPED state are allowed. 


DSNU250I_ _ csect-name UNLOAD PHASE COMPLETE, 


ELAPSED TIME = hh/mm/ss 


Explanation: The UNLOAD phase of the REORG utility com- 
pleted normally. The time that elapsed between the beginning 
of the REORG utility and the completion of the UNLOAD phase 
was hh/mm/ss, hours, minutes, and seconds, respectively. 


——————— Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNURULD 


(eee End of Internal DB2 Information Beet | 


Severity: 0 (informational) 
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System Action: Action subsequent to this message depends on 
the UNLOAD option of the REORG utility statement: 


e Ifthe UNLOAD option is CONTINUE, execution of the utility 
continues into the RELOAD phase. 


e {fthe UNLOAD option is PAUSE, execution of the utility is 
stopped at the beginning of the RELOAD phase. 


¢ If the UNLOAD option is ONLY, the REORG utility is finished. 
Processing continues to the next utility in the utility job- 
step, or, if there are no more utility statements, the utility 
job-step terminates normally. 


User Response: The user’s response depends on the UNLOAD 
option in the REORG utility statement. 


¢ Ifthe UNLOAD option is CONTINUE, no user response is 
required. The message is informational only. 

¢ {fthe UNLOAD option is PAUSE, the REORG utility is 
stopped in the reload phase. To complete the REORG 
process, the user must explicitly restart the utility job-step 
using the RESTART(PHASE) option. 

¢ Ifthe UNLOAD option is ONLY, the REORG utility has com- 
pleted, and the requested output is on the data set identi- 
fied by the DD card of the UNLDDN REORG utility statement 
option. 


Operator Response: The operator’s response depends on the 
UNLOAD option of the REORG statement: 


¢ If the UNLOAD option is CONTINUE, no operator response is 
required. The execution of the REORG utility is proceeding. 

¢ {f the UNLOAD option is PAUSE, further processing is 
dependent upon restarting the utility job-step with the 
RESTART(PHASE) option. Until that time, resources are 
held exclusively by the REORG utility job-step. 

¢ Ifthe UNLOAD option is ONLY, the REORG utility processing 
is complete. The data set defined by the DD card nominated 
by the UNLDDN option is available for installation disposi- 
tion. 


DSNU2521_ _csect-name UNLOAD PHASE STATISTICS. 


NUMBER OF RECORDS = mmmmmm FOR tttttttt 


Explanation: This message is issued at the completion of the 
UNLOAD phase of the REORG utility. It gives the number of 
records that were unloaded ('‘mmmmmm') for the indicated 
table space ( 'tttttttt'). 


ae ~ Internal DB2 Information ge ee ae | 
This message is issued by the following CSECT(s): DSNURFIT 


Seren End of internal DB2 Information eee 


Severity: 0 (informational) 


System Action: Only valid table records are unloaded. 
Dropped table record counts are not reported. 


User Response: Record count represents the current 
cardinality of the indicated table. Invocation of the RUNSTATS 
utility and a subsequent rebinding of the involved PLANs should 
be considered if this value differs greatly from the 
SYSTABLE.CARD value, so that the SQL optimizer can bring the 
PLANSs up to date. 


Operator Response: Count can be indicative of the amount of 
processing remaining. 
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DSNU256I_ = csect-name INVALID PARTITION SPECIFICATION 


Explanation: This message is issued by the LOAD, REORG, 
RECOVER INDEX, and REPAIR UTILITIES in response to an 
invalid PART option specification. 


A PART option is invalid if it is specified for a nonpartitioned 
table space, or if the indicated PART integer is not pertinent to 
the partitions existing for the indicated table space. 


The utility job-step is terminated. 


a — Internal DB2 Information ” “| 


This message is issued by the following CSECT(s): DSNURFIT, 
DSNURWET, DSNUCBRS, DSNUCRIX 


{|S sEnd of Internal DB2 Information ______———_—id 


Severity: 8 (error) 
Refer to “Utilities Message Severity Codes” on page 3-155. 


System Action: The error is sufficient to terminate further proc- 
essing of the utility job-step. The utility job-step is terminated, 
and resources are released to their prior state. 


User Response: Determine the correct partition specification 
for the table space that was the subject of the specified control 
utility statement, and resubmit the utility job-step. 


Problem Determination: Examination of 
SYSIBM.SYSTABLESPACE in the DB2 catalog indicates the 
correct range of partition numbers for the table space. 


DSNU257I_ _csect-name UNABLE TO RESTART BUILD PHASE 


Explanation: Any RESTART of a BUILD PHASE of a LOAD utility 
with the RESUME(YES) option is not permitted. The REORG 
utility, or the LOAD utility with a RESUME(NO), can be restarted 
only at the beginning of the phase (RESTART PHASE), not at the 
last commit point (RESTART). One of the above conditions was 
violated. 


ae. Internal DB2 Information eS ee ei 
This message is issued by the following CSECT(s): DSNURBXD 


{Ss End of Internal DB2 Information 


Severity: 8 (error) 
System Action: Utility processing is not initiated. 


User Response: If attempting to RESTART a REORG or a utility 
with the RESUME(NO) option, change the RESTART option to 
RESTART PHASE and resubmit the job-step. If the option was 
LOAD RESUME(YES), RECOVER the indexes of the tables that 
were loaded by the LOAD RESUME(YES) request. 


Problem Determination: Refer to Chapter 3 of Command and 
Utility Reference and Section 3 (Volume 1) of Administration 
Guide for a discussion of LOAD and reorganization restarting 
constraints. 


csect-name BUILD PHASE STATISTICS. NUMBER 
OF INDEXES = mmm 


DSNU258I 


Explanation: This message is issued at normal completion of 
the BUILD phase of the LOAD or REORG or RECOVER INDEX 
utility. The number of indexes that were updated is indicated as 
‘mmm'. 


f =e Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNURBXD, 
DSNUCRIX 


[End of Internal DB2 Information ___———_— 


Severity: 0 (informational) 


System Action: The BUILD phase of either the LOAD or REORG 
or RECOVER INDEX utility is completed. Upon completion of 
the utility job-step, they are available for REFERENCE proc- 
essing. 


DSNU2591_ _—scsect-name BUILD PHASE COMPLETE, ELAPSED 


TIME = hh/mmi/ss 


Explanation: This message is issued at the normal completion 
of the BUILD phase of the REORG, LOAD, and RECOVER INDEX 
utilities. The time that has elapsed between the beginning of 
the phase and the completion of this phase was 'hh' hours, 
‘mm' minutes, and 'ss' seconds. 


[ cay) Internal DB2 Information 


This message is issued by the following CSECT(s): DSNURBXD, 
DSNUCRIX 


Neko eee, End of Internal DB2 Information Git ote 


System Action: Processing continues to the next phase of the 
LOAD or REORG or RECOVER INDEX utility. If this is the last 
phase, processing continues to the next utility statement in the 
utility job-step, if any. 


DSNU260I csect-name TABLE SPACE IS EMPTY 


Explanation: The table space nominated by the utility state- 
ment is empty. For RECOVER INDEX, this message is issued 
when RECOVER INDEX(ALL) is specified on an empty table 
space. 


[ —— Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUBBFR, 
DSNURFIT, DSNUCRUL 


Pee eee End of Internal DB2 Information ee 


Severity: 4 (warning) 


System Action: The current utility function is considered com- 
pleted, and the next utility function in the utility job-step, if any, 
is initiated. 
DSNU270I_ _—scsecct-name - tabie-name, column-name IN ViO- 
LATION OF INSTALLATION DEFINED FIELD PRO- 
CEDURE procedure-name. function-code, 
return-code, reason-code, message-token. 


Explanation: An installation-supplied field procedure has 
returned an error during encoding for LOAD or decoding for 
REORG. See SQL code -681 for more detail. 


DSNU2591 — DSNU280I 


t= Internal DB2 Information age ~ 


This message is issued by the following CSECT(s): DSNURFBR, 
DSNURWBG 


ae nS End of Internal DB2 Information Ret see 


Severity: 8 (error) 


System Action: The utility will issue a system '04E' abend with 
a reason code of '00E40336'. 


User Response: Request the dump produced as a result of the 
error to the system programmer so that the cause of the error 
can be determined and corrected. 


System Programmer Response: Examine the field procedure 
to determine why an error return code was generated. Refer to 
Chapter 3 of Command and Utility Reference for more informa- 
tion. 


DSNU2721 _csect-name - FIELD PROCEDURE procedure-name 


COULD NOT BE LOADED 


Explanation: An installation supplied field procedure could not 
be loaded during encoding for LOAD or decoding for REORG. 
See SQL code -682 for more detail. 


i.e Internal DB2 Information an 
This message is issued by the following CSECT(s): DSNURFIT 


—— aa End of Internal DB2 Information eens 


Severity: 8 (error) 


System Action: The utility will terminate with a return code of 
8. 


User Response: Take the job output to the system pro- 
grammer. 


System Programmer Response: Determine why the fieid pro- 
cedure could not be loaded. 


DSNU280I csect-name - ERROR = X'reason-code' FROM 


EDIT ROUTINE procedure-name FOR table-name 


Explanation: The edit routine provided by your installation has 
returned an error during the load of a record into the table indi- 
cated. The reason code is set by the edit routine. 


oe Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNURWBF 


be ee End of internal DB2 Information Pe ee ot 


Severity: 8 (error) 


System Action: The LOAD or REORG utility will! receive 
ABENDO4E RC00E40323. 


User Response: Correct any errors in the input data. Ensure 
that the edit routine provided is correct. The utility can be 
restarted or terminated. 


System Programmer Response: Verify that the edit routine is 
correct. 
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DSNU2811 — DSNU304I 


DSNU281I csect-name RECORD (n) OF TABLE table-name 
VIOLATING VALID ROUTINE validproc-name, 
ERROR =X 'reason-code' 


Explanation: The validation exit routine provided by your 
installation blocked the load of record 'n' into TABLE 
'table-name'. The reason-code was set by the exit routine. 


| Internal DB2 Information me ey : 
This message is issued by the following CSECT(s): DSNURWBF 


ere End of Internal DB2 Information ones st 


Severity: 4 (warning) 


System Action: The LOAD utility continues to process the fol- 
lowing input record. 


User Response: Check the error input records against the 
error reason code returned from the valid procedure. Refer to 
Chapter 3 of Command and Utility Reference for a definition of 
LOAD input field column specifications. 


System Programmer Response: Verify that the validation 
routine is correct. 


DSNU300I_ _ csect-name (RE)LOAD PHASE COMPLETE, 


ELAPSED TIME = hh/mmiss 


Explanation: The reload phase of the REORG or LOAD utility 
has compieted normally. The elapsed time for the execution 
was 'hh' hours, 'mm' minutes, and 'ss' seconds. 


ee ~— Internal DB2 Information ~ = | 
This message is issued by the following CSECT(s): DSNURELD 


ee End of internal DB2 Information eae 


csect-name (RE)LOAD PHASE STATISTICS. 
NUMBER OF INPUT RECORDS PROCESSED = 
nannnannn 


DSNU302I 


Explanation: This message is issued at the normal completion 
of the RELOAD phase of the REORG utility and the LOAD phase 
of the LOAD utility. 


It indicates the number of records processed from the input 
record data set (that is, the data set identified either by the JCL 
DD card identified in the UNLDDN option for REORG or the 
INDDN option for LOAD). 


| Internal DB2 Information i ] 


This message is issued by the following CSECT(s): DSNURILD, 
DSNURWBF 


fete ce Se ace End of Internal DB2 Information eer | 


Severity: 0 (informational) 


System Action: The LOAD or REORG utility completes the 
phase in which the records are (re-}introduced into the DB2 
database. This is also the last phase of the utility unless there 
are some indexes that need to be built and/or updated. 


User Response: The user can verify that the number of records 
(re-)loaded is consistent with expectations. For example, in 
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REORG it matches the total number of records unloaded. For 
LOAD, it matches the number of records submitted minus the 
number or records reported rejected. 


DSNU3031 csect-name (RE)LOAD PHASE STATISTICS. 
NUMBER OF RECORDS = nnnnnn FOR TABLE 


table-name PART = part-number 


Explanation: This message is issued at the normal completion 
of the RELOAD phase of the REORG utility and the LOAD phase 
of the LOAD utility. 


It indicates the number of records loaded into PART 
'part-number' of 'table-name' from the source record data set. 
This data set is identified by the JCL DD card in the UNLDDN 
option for REORG, or the INDDN option for LOAD. 


This message is repeated for each INTO TABLE PART clause in 
the LOAD utility statement or each TABLESPACE PART clause 
in the REORG utility statement. 


[OS™ Internal DB2 Information — 
This message is issued by the following CSECT(s): DSNURWT 


———— End of Internal DB2 Information er eee | 


Severity: 0 (informational) 


System Action: The LOAD or RELOAD phase maintains a sepa- 
rate count for each table part. Rejected rows are not included 
in the count. Each count is reported as a separate message at 
the end of the LOAD or RELOAD phase. 


The user can verify the number of records loaded or reloaded 
into the table part. In REORG, it should match the number of 
records unloaded for that table part. In LOAD, it should match 
the number of records processed. 


DSNU304I csect-name (RE)LOAD PHASE STATISTICS. 
NUMBER OF RECORDS = nnnonn FOR TABLE 


table-name 


Explanation: This message is issued at the normal completion 
of the RELOAD phase of the REORG utility and the LOAD phase 
of the LOAD utility. 


It indicates the number of records loaded into TABLE 
'table-name' from the source record data set (that is, the data 
set identified by the JCL DD card identified in the UNLDDN 
option for REORG, or the INDDN option for LOAD). 


This message is repeated for each TABLE loaded by the current 
REORG or LOAD utility statement. 


If the LOAD or REORG was restarted in a LOAD or RELOAD 
phase from the last commit point (i.e., the 'RESTART' parm 
was specified), 'nnnnnn' indicates the number of records 
loaded after the restart. 


| Internal DB2 Information 7 | 
This message is issued by the following CSECT(s): DSNURWT 


eer, End of Internal DB2 Information ere 


Severity: 0 (informational) 


System Action: The LOAD or RELOAD phase maintains a sepa- 
rate count for each table populated by this phase. Rejected 
rows are not included in the count. Each count is reported as a 
separate message at the end of the LOAD or RELOAD phase. 


The user can verify that the number of records (re-)loaded into 
the table is consistent with expectations. For example, in 
REORG it matches the number of records unloaded for that 
table. For LOAD, it matches the number of records processed. 


DSNU3051 csect-name - TABLE = table-name HAS AN 


INCOMPLETE TABLE DEFINITION 


Explanation: Table 'table-name' does not have an index 
defined to enforce the uniqueness of its primary key. 


i. Internal DB2 Information —— 
This message is issued by the following CSECT(s): DSNURWET 


Lo End of Internal DB2 Information _ id 


Severity: 8 (error) 


System Action: Processing stops. No table in the table space 
is loaded. 


User Response: The user can resubmit the LOAD job after 
either: 


¢ Creating a unique index over the table’s primary key 
¢ Dropping the definition of the table’s primary key. 


Problem Determination: Issue SQL SELECT against the catalog 
to determine which indexes and relations exist against 
‘table-name'., Determine whether uniqueness of the primary 
key has been guaranteed through omission or through faulty 
definition of an index. 


DSNUSO6I  csect-name - UNABLE TO OBTAIN lock-type LOCK 


ON object-type object-name 


Explanation: The utility requested a LOCK on 'object-name' 
and was denied because the resource was unavailable. 
Message DSNT500I gives information about why the resource 
was unavailable. 


T.COt™~SCS Internal DB2 Information a | 
This message is issued by the following CSECT(s): DSNURWIL 


ae End of Internal DB2 Information ee 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: If issued by the LOAD utility, the 
‘object-name' is a parent table space that must be accessed to 
provide referential constraint enforcement. The LOAD job may 
be rerun with constraint enforcement when the necessary table 
spaces become available, or it may be rerun without constraint 
enforcement. 


Problem Determination: Refer to message DSNT500I or issue 
the -DISPLAY command for 'object-name' to determine why it 
is unavailable. 


DSNU305!I — DSNU308I 


DSNU3071 csect-name PARENT TABLE parent-table-name 
OF table-name IN RELATIONSHIP relationship- 


name HAS AN INCOMPLETE TABLE DEFINITION 


Explanation: The 'table-name' identifies the target table of the 
job for the LOAD utility or the dependent table to be checked by 
the CHECK DATA utility. The 'parent-table-name' identifies the 
parent table of the target table for the LOAD utility or the 
dependent table for the CHECK DATA utility in RELATIONSHIP 
‘relationship-name'. The primary index of PARENT TABLE 
'parent-table-name' has been dropped. 


This message is repeated for each incompletely defined parent 
table in each relationship where the target table is a child. 


| internal DB2 Information eae 


This message is issued by the following CSECT(s): DSNURWIL, 
DSNUKINL 


Petes End of Internal DB2 information ee 


Severity: 8 (error) 


System Action: The LOAD and CHECK DATA utilities stop 
further processing. No data is loaded by the LOAD utility and 
no relationships are checked by the CHECK DATA utility. 


User Response: Check the existence of the primary index and 
its parent tables identified by RELATIONSHIP 
‘relationship-name'. 


Problem Determination: Ifthe incompletely defined tables 
were targets of the LOAD job, message DSNU305! has been 
issued for each such table. Refer to the catalog to determine if 
any tables in the table space that were not targets of the LOAD 
job are incompletely defined. 


DSNU308! module-name INDEX KEY LIST RECORD LENGTH 


EXCEEDS MAXIMUM KEY BUFFER SIZE 


Explanation: The length of the index key list that will be built in 
the Data Base Services address space while loading a data 
record may be larger than the maximum key buffer size. The 
LOAD statement may be too complex. 


Internal DB2 Information — > ee 
This message is issued by the following CSECT(s): DSNURWI 


Ue ees End of Internal DB2 Information es el 


Severity: 8 (error) 
System Action: Utility processing is terminated. 


User Response: Examine the preceding DSNU6501 INTO TABLE 
statements. The key size and number of indexes affected by 
each INTO TABLE statement are accumulative. The combina- 
tion of these elements may produce a list of index keys, 
including header bytes, that is too large to be contained within 
the maximum size buffer area during the load of each input 
data record. It may be necessary to reduce the number of INTO 
TABLE statements or to drop some of the indexes that are 
affected by the load. 
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DSNU310! csect-name RECORD 'n' WILL BE DISCARDED 
DUE TO fieid-name CONVERSION ERROR FOR 


table-name 


Explanation: The ioad utility found the input data provided for a 
field to be incorrect. The corresponding input data set record 
'n' will be placed in the DISCARDS data set. 


| Internal DB2 Information ~~ ae 
This message is issued by the following CSECT(s): DSNURWBG 


an End of Internal DB2 Information et es 


Severity: 4 (warning) 


System Action: The input data set record is noted and will be 
discarded in the DISCARD phase. The LOAD utility continues to 
process additional records in the input data set. 


User Response: Following the completion of the current LOAD 
utility invocation, examine the record in the DISCARDS data set. 
Correct the error in the discarded input data. Submit a 
RESUME(YES) LOAD invocation with the DISCARDS data set as 
the input data set. Refer to Chapter 3 of Command and Utility 
Reference for a definition of LOAD input field column specifica- 
tions. 


DSNU311I csect-name RECORD 'n' WILL BE DISCARDED 
DUE TO INVALID field-name COLUMN SPECIFICA- 


TION 


Explanation: The load utility calculated the location of an input 
data vaiue using the field specifications supplied and VARCHAR 
fength fields present within the input data set record. The cal- 
culated position for the field was determined to be incorrect. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNURWBF 


———er End of Internal DB2 Information es, 


Severity: 4 (warning) 


System Action: The input data set record number is noted and 
will be discarded in the DISCARD phase. The LOAD utility con- 
tinues to process additional records in the input data set. 


User Response: Following the completion of the current LOAD 
utility invocation, examine the record in the DISCARDS data set. 
Correct the error in the discarded input data, if one exists. Oth- 
erwise, correct the input field specification. Submit a 
RESUME(YES) LOAD invocation which uses the DISCARDS data 
set and the verified LOAD utility statement and field specifica- 
tions. Refer to Chapter 3 of Command and Utility Reference for 
' a definition of LOAD input field column specifications. 


DSNU3121  csect-name RECORD 'n' WILL BE DISCARDED 
DUE TO ERROR = X'reason-code' FROM EXIT 


ROUTINE procedure-name FOR table-name 


Explanation: The exit routine provided by your installation 
blocked the load of record 'n' into the table indicated. The 
reason-code was set by the exit routine. 
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ii ~~~ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNURWBF 


es End of Internal DB2 Information te See 


Severity: 4 (warning) 


System Action: The input data set record number is noted and 
will be discarded in the DISCARD phase. error is placed in the 
DISCARDS data set. The LOAD utility continues to process 
additional records in the input data set. 


User Response: Following the completion of the current LOAD 
utility invocation, examine the record in the DISCARDS data set. 
Correct the error in the discarded input data, if one exists. 
Ensure that the exit routine provided is correct. Submit a 
RESUME(YES) LOAD invocation which uses the DISCARDS data 
set and the verified LOAD utility statement and field specifica- 
tions. Refer to Chapter 3 of Command and Utility Reference for 
a definition of LOAD input field column specifications. 


System Programmer Response: Verify that the validation 
routine is correct. 


DSNU313I ~=csect-name RECORD 'n' WILL BE DISCARDED 


DUE TO PART SPECIFICATION(S) 


Explanation: The discarded record does not belong to any of 
the partitions being loaded. 


—— Internal DB2 Information rs: 
This message is issued by the following CSECT(s): DSNURWBF 


Vie oS: End of Internal DB2 Information ee 


Severity: 4 (warning) 


System Action: The input data set record number is noted and 
will be discarded in the DISCARD phase. The LOAD utility con- 
tinues to process additional records in the input data set. 


User Response: Following the completion of the current LOAD 
utility invocation, examine the record in the DISCARDS data set. 
Correct the error in the discarded input data, if one exists. 
Submit a RESUME(YES) LOAD invocation with the DISCARDS 
data set as the input data set. Refer to Chapter 3 of Command 
and Utility Reference for a definition of LOAD input field column 
specifications. 


System Programmer Response: Verify that the validation 
routine is correct. 


DSNU3141 csect-name RECORD 'n' WILL BE DISCARDED 


DUE TO WHEN SPECIFICATION(S) 


Explanation: The discarded record satisfies none of the WHEN 
selection expressions provided. 


| Internal DB2 Information eee ae | 
This message is issued by the following CSECT(s): DSNURWBF 


Diego ow End of Internal DB2 Information | 


Severity: 4 (warning) 


System Action: The input data set record is noted and will be 
discarded in the DISCARD phase. The LOAD utility continues to 
process additional records in the input data set. 


User Response: Following the completion of the current LOAD 
utility invocation, examine the record in the DISCARDS data set. 
Correct the error in the discarded input data, if one exists. 
Submit a RESUME(YES) LOAD invocation with the DISCARDS 
data set as the input data set. Refer to Chapter 3 of Command 
and Utility Reference for a definition of LOAD input field column 
specifications. 


DSNU315! csect-name RECORD 'n' WILL BE DISCARDED 


DUE TO UNEXPECTED ERROR 


Explanation: The LOAD of input data set record number 'n' 
was attempted but was not successful due to an unexpected 
error. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNURWBF 


Wee End of internal DB2 Information oota 


Severity: 8 (error) 


System Action: If the error was caused because a resource 
was not available, a DSNT500I message will be issued. 


The utility step will be abended with a system X'04E' and an 
abend reason code of '00E40318'. If a DSNT500!I message is 
not issued, an SVC dump will be requested. A SYSABEND 
dump of batch storage is also requested. 


User Response: lf a DSNT5001 message was issued, refer to 
the description under that message number. If the unavailable 
resource becomes available, the utility step is restartable. 


If there is no DSNT500I message, the error is an unexpected 
internal error and you should consult your system programmer. 


Operator Response: An operator with SYSOPR authority can 
issue a TERM UTIL to free any held resources if that should 
prove necessary. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference and to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures. 


DSNU3171_ —csect-name DISCARD LIMIT HAS BEEN REACHED 


Explanation: The DISCARDS limit specified on the LOAD utility 
statement has been reached. 


Severity: 8 (error) 


System Action: Processing abnormally terminates to allow 
users to increase the discard limit and restart the utility. 


User Response: Increase the discard limit and restart the 
utility. Otherwise -TERM the utility. Review the file of input 
records provided to LOAD and review table definitions to deter- 
mine why the number of records discarded exceeds expecta- 
tions. 


Problem Determination: See user response. 


DSNU3151 — DSNU321I 


csect-name RECORD 'n' WILL BE DISCARDED 
DUE TO INVALID field-name COLUMN SPECIFICA- 
TION FOR table-name 


DSNU3181 


Explanation: The load utility calculated the location of an input 
data value using the field specifications supplied and VARCHAR 
length fields present within the input data set record 'n'. The 

calculated position for the field was determined to be incorrect. 


a ~~ Interna! DB2 Information ~~ Sf 


This message is issued by the following CSECT(s): DSNURWBF, 
DSNURWBG 


ae End of Internal DB2 Information eee eel 


Severity: 4 (warning) 


System Action: The input data set record number is noted and 
will be discarded in the DISCARD phase. The LOAD utility con- 
tinues to process additional records in the input data set. 


User Response: Foilowing the completion of the current LOAD 
utility invocation, examine the record in the DISCARDS data set. 
Correct the error in the discarded input data, if one exists. Oth- 
erwise, correct the input field specification. Submit a 
RESUME(YES) LOAD invocation which uses the DISCARDS data 
set and the verified LOAD utility statement and field specifica- 
tions. Refer to Chapter 3 of Command and Utility Reference for 
a definition of LOAD input field column specifications. 


DSNU3201 csect-name RESUME(YES) WAS SPECIFIED FOR 


EMPTY TABLESPACE 


Explanation: This message is issued in response to a LOAD 
utility request containing a RESUME(YES) option. The 
RESUME(YES) option implies that the nominated table space is 
populated, but in this case it was not. The message alerts the 
invoker to this fact, and continues as if RESUME(YES) was not 
specified. 


| internal DB2 Information ~~ icaiaes| 
This message is issued by the following CSECT(s): DNSURWIT 


| Ss End of Internal DB2 Information 


Severity: 4 (warning) 


System Action: The LOAD utility, in attempting to honor the 
RESUME(YES), found the table space to be empty and so 
ignored the option and proceeded as if RESUME(NO) was spec- 
ified. 


User Response: The user is alerted to the fact that the 
requested table space was empty rather than populated as the 
RESUME LOAD option implied. 


DSNU321I1 ~—csect-name CHECK PENDING STATE OF 


TABLESPACE tsp PROHIBITS PROCESSING 


Explanation: The requested utility may not be run against a 
table space in a CHECK PENDING state. 
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DSNU323i — DSNU329I 


| > = ; Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNUGSRI 


ieee ee End of Internal DB2 Information ot 


Severity: 8 (error) 


System Action: Processing will terminate after the CHECK 
PENDING states of all target table spaces of the utility are ana- 
lyzed. 


User Response: Remove the named table space from its 
CHECK PENDING state through use of the CHECK or REPAIR 
utility. 


Problem Determination: If more information on the extent of 
questionable data in the table space is desired, query the 
SYSTABLES and SYSTABLEPART catalog tables. 


DSNU3231  csect-name COLUMN ccc IS OMITTED 


Explanation: The column 'ccc' is a non-nullable column and is 
not being loaded. Field specifications must include all non- 
nullable columns. The identified column name was missing 
from the field specification. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNURWUF 


LL seEnd of internal DB2 information _____——_—| 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Determine if the input data contains the non- 
nullable column as a field. If it does, change the field specifica- 
tion to include it. If the input data does not contain the 
non-nullable column as a field, determine which is in error, the 
input data or the column specification. Make the corresponding 
correction. Resubmit the job if that is still appropriate. 


System Programmer Response: Corrective procedures may 
require that a table be dropped and created again. Refer to 
Section 3 (Volume 1) of Administration Guide for a discussion of 
how this can be accomplished. Refer to Chapter 3 of Command 
and Utility Reference for a discussion of fieid specification con- 
straints with regard to non-nullable columns. 


DSNU325I_ _—scsect-name - AN INVALID SQL/DS FORMAT 


RECORD WAS ENCOUNTERED 


Explanation: The LOAD utility detected an invalid SQL/DS 
format record type. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNURWBF 


ere End of Internal DB2 Information ence stat 


Severity: 8 (error) 
System Action: Utility execution is terminated. 


User Response: Correct the input data and resubmit the job. 
Data that has been transmitted from an SQL/DS unload disk 
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data set in a VM/370 system may have extra block descriptors 
and record descriptors at the beginning of each record. Ensure 
that this situation does not exist. 


Problem Determination: Refer to Section 3 (Volume 1) of 
Administration Guide for additional information regarding 
loading data from SQL/DS and resubmitting a partially com- 
pleted load step. 


DSNU326I ~—scsect - USER NOT AUTHORIZED FOR LOAD 


REPLACE ON TABLESPACE 


Explanation: The indicated user attempted to use the 
REPLACE option of LOAD, and it will reset to empty all tables in 
the table space before loading data. This option requires load 
authorization on each table in the table space, but the user did 
not have authority for one or more tables. 


Severity: 


System Action: When LOAD REPLACE validation encounters 
the first non-authorized table in the table space, the job-step is 
terminated. 


12 (severe error) 


User Response: Obtaining the LOAD on DATABASE privilege 
for the database will allow you to proceed using the REPLACE 
option. The other alternative is to first delete all rows from the 
tables which are to be loaded, and then use the RESUME option 
instead of the REPLACE option. 


DSNU3271 csect-name TABLE b IS NOT IN SAME 


TABLESPACE AS TABLE a 


Explanation: All tables that are the subject of a single LOAD 
utility statement must belong to the same table space. 


i —- Internal DB2 Information a Eee 
This message is issued by the following CSECT(s): DSNURWI 


pee ees End of Internal DB2 Information ce 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Remove the INTO TABLE control statement 
that specifies TABLE 'b' from the current LOAD request. If the 
data is to be loaded into TABLE 'b', create another LOAD utility 
statement that contains the INTO TABLE contro! statement for 
TABLE 'b' and resubmit the job. 


DSNU329I_ _—sccsect-name - FIELD field-name IS NOT 


DEFAULTABLE 


Explanation: You specified a NULLIF or DEFAULTIF field spec- 
ification option for: 


¢ Acolumn defined to be not nullable or not defaultable 
e A field with no column counterpart. 


es ~~ Internal DB2 Information ] 


This message is issued by the following CSECT(s): 
DSNURCON, DSNURWUF 


ee End of Internal DB2 Information ea | 


Severity: 8 (error) 


System Action: The utility abends to allow restart. 


User Response: Determine whether the field specification 
refers to the correct column. If it does, remove the NULLIF 
option from the field specification, and restart the job. Alterna- 
tively, TERM the utility. Refer to Chapter 3 of Command and 
Utility Reference for LOAD NULLIF option constraints. 


DSNU3301 csect-name TABLESPACE IS NOT EMPTY 


Explanation: The RESUME keyword either specified or 
defaulted to a value of NO, which requires an empty table 
space. However, the LOAD command named a table space that 
was not empty. 


[ ~~ Internal DB2 Information . ; 
This message is issued by the following CSECT(s): DSNURWES 


eae 5 ee End of Internal DB2 Information ee aee | 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Determine why the assumption of an empty 
table space was wrong. This may require consultation with the 
system programmer. Either remove the current table(s) rows 
using an SQL DELETE, or change the LOAD option to RESUME 
YES. Resubmit the job. Refer to Chapter 3 of Command and 
Utility Reference for a definition of the RESUME option of LOAD. 


System Programmer Response: If the table space is used by 
more than one application, determine whether the table space 
should be empty. If it should be, use SQL DELETE to make it 
empty. Otherwise, instruct the user to use the RESUME(YES) 
option. 


DSNU331I  csect-name FIELD LISTS ARE NOT ALLOWED 


WITH FORMAT KEYWORD 


Explanation: LOAD field specifications are incompatible with 
the FORMAT option. 


[ . 7 Interna! DB2 Information | 
This message is issued by the following CSECT(s): DSNURWUT 


Ne ee End of Internal DB2 Information ae eee 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Determine whether the field specifications or 
the FORMAT option is correct. Eliminate whichever is incor- 
rect, and resubmit the job. Refer to Chapter 3 of Command and 
Utility Reference for a definition of the LOAD FORMAT option 
constraints. 


DSNU3321 csect-name - INPUT VALUE X'hex-data' OUT OF 


RANGE FOR COLUMN 'column-name' 


Explanation: The LOAD utility detected a numeric value 
outside of the range of permissible values for the column in the 
DB2 table. A loss of significant digits results if the LOAD 
process continues. The input data type is SMALL INTEGER, 
INTEGER, DECIMAL, or FLOAT and is displayed in hexadecimal. 


DSNU3301 — DSNU334I 


ios Internal DB2 Information a er 
This message is issued by the following CSECT(s): DSNURWBG 


| End of internal DB2 Information | 


Severity: 8 (error) 


System Action: Further utility processing is terminated unless 
DISCARD processing is active. 


User Response: Correct the input data and resubmit the job. 
To correct the data, you might have to alter: 


¢ The table used 
¢ The input depending on RESUME 
¢ The LOG options specified for the LOAD process. 


Refer to Chapter 3 of Command and Utility Reference to deter- 
mine input constraints. Refer to Section 3 (Volume 1) of Admin- 
istration Guide for information on resubmitting a partially 
completed LOAD step. 


DSNU3331 csect-name - INPUT VALUE 'ebcdic-data' OUT 


OF RANGE FOR COLUMN 'column-name' 


Explanation: The LOAD utility detected a numeric value 
outside the range of permissible values for the column in the 
DB2 table. A loss of significant digits will result if the LOAD 
process continues. The input data type is INTEGER EXTERNAL, 
DECIMAL EXTERNAL, or FLOAT EXTERNAL. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNURWBG 


bere eee End of Internal DB2 Information gee a 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Correct the input data and resubmit the job. 
To correct the data, you might have to alter: 


¢ The table used 
¢ The input depending on RESUME 
¢ The LOG options specified for the LOAD process. 


Refer to Chapter 3 of Command and Utility Reference to deter- 
mine input constraints. Refer to Section 3 (Volume 1) of Admin- 
istration Guide for information on resubmitting a partially 
completed LOAD step. 


DSNU3341 csect-name INPUT FIELD ffffffff INVALID FOR 


tttttttt, ERROR CODE cc 


Explanation: The LOAD utility found the input data provided for 
field 'ffffffff' in table 'tttttttt' to be incorrect. The error code 
‘cc’, if present, identifies the problem. Possible error codes 
are: 


01 Input numeric value is out of the range for the table 
column. 

02 Input numeric field contains invalid numeric data. 

03 There was an error converting input numeric data to 
floating-point data. 

04 Input packed decimal data is in error. 

05 Input is too long for a date column. 

06 Input is too short for a date column. 

07 Input is too long for a time column. 

08 Input is too short for a time column. 
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09 Input is too long for a timestamp column. 

10 Input is too short for a timestamp column. 

11 Input character field is too large for the table column. 

12 Input variable character field is too large for the table 
column. 

13° Input is out of range for the date/time column. 

14 Input is invalid for the date/time column. 

15 input length is incorrect for numeric column. 

16 Input contains a blank character. 

17 Input is too long for a graphic column. 

18 _— ‘Input is invalid for a graphic column. 


| Internal DB2 Information Si oy “| 
This message is issued by the following CSECT(s): DSNURWBG 


oer aes End of Internal DB2 Information oie ed 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Correct the input data and resubmit the job. 
To correct the data, you might have to alter: 


e¢ The input data 
* The column specification 
® The table used. 


Refer to Chapter 3 of Command and Utility Reference to deter- 
mine input constraints. Refer to Section 3 (Volume 1) of Admin- 
istration Guide for information on resubmitting a partially 
completed LOAD step. 


DSNU335I_ = csect-name_ INPUT FIELD 'ffffffff' NOT ENTIRELY 


WITHIN INPUT RECORD 


Explanation: The LOAD utility found that the input field ‘ fffffftf' 
extends beyond the end of the input record. 


[ — ‘Internal DB2 Information Ss 
This message is issued by the following CSECT(s): DSNURWBG 


Beets End of Internal DB2 Information gute ee) 


Severity: 8 (error) 


System Action: Further utility processing is terminated unless 
discards processing is active: 


User Response: Correct the input data and resubmit the job. 
To correct the data, you might have to alter: 


¢ The tabie used 
¢ The input data set 
¢ The LOAD statement. 


Refer to Chapter 3 of Command and Utility Reference to deter- 
mine input constraints. Refer to Section 3 (Volume 1) of Admin- 
istration Guide for information on resubmitting a partially 
completed LOAD step. 


DSNU336I csect-name INVALID NULLIF SPECIFICATION FOR 


INPUT FIELD ffttttft 


Explanation: The LOAD utility found the ‘nullif' field specifica- 
tion to be incorrect. 
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[- Internal DB2 Information 1 


This message is issued by the following CSECT(s): DSNURWBF, 
DSNURWBG 


ae End of internal DB2 Information ete 23] 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Correct the 'nullif' specification and resubmit 
the job. Refer to Chapter 3 of Command and Utility Reference 
for a description of 'nullif' field selection options. Section 3 
(Volume 1) of Administration Guide for information on resubmit- 
ting a partially completed LOAD step. 


DSNU338I csect-name INVALID COLUMN SPECIFICATION 


FOR column name 


Explanation: The LOAD utility found the dynamicaily deter- 
mined column location for an input field to be incorrect. 


| ~~~ _ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNURUFL, 
DSNURWBF 


fee ee End of Internal DB2 Information page 


Severity: 8 (error) 
System Action: The utility abends to allow restart. 


User Response: Correct the input field specification or the 
input data and restart the job. Alternatively, TERM the utility. 


DSNU3391 _csect-name INVALID CONTINUEIF SPECIFICATION 


Explanation: The CONTINUEIF clause of a LOAD utility extends 
beyond the end of the input record. 


js. Internal DB2 Information es, 
This message is issued by CSECT(s): DSNURELD 


[eae s eee End of internal DB2 Information eens on] 


Severity: 8 (error) 
System Action: The LOAD utility is terminated. 


User Response: Correct the CONTINUEIF clause. The column 
specification must be reduced and/or the value being compared 
must be shortened. The value being compared must be entirely 
within the input record. 


DSNU340I_~_—scsect-name - ERROR LOADING INDEX, DUPLI- 
CATE KEY, INDEX = index-name, 

TABLE = table-name, RID OF INDEXED 

ROW = rid-of-indexed-row, RID OF NON-INDEXED 


ROW = rid-of-non-indexed-row 


Explanation: A duplicate key was found while building the indi- 
cated index during the BUILD phase of the REORG or RECOVER 
INDEX utility. This violates the uniqueness rule for that index. 


Internal DB2 information | 
This message is issued by the following CSECT(s): DSNURBXA 


[snd of Internal DB2 Information _____—_—d 


Severity: 8 (error) 


System Action: Ai! duplicate index entries of the indicated 
index are reported and the index is in RECOVERY PENDING 
status. Duplicate rows are present in the indexed table. 


Utility processing continues with any other utility functions 
within the utility job-step. 


User Response: Duplicate rows are present in the indexed 
table. The system programmer should be informed, so that any 
applications that are dependent upon the uniqueness of the 
table rows are not initiated until corrective action has been 
taken. 


Operator Response: Notify the system programmer. 


System Programmer Response: Steps should be taken to 
inhibit any further processing until the index is repaired. If the 
non-unique keys are correct, DROP and recreate the index as 
non-unique. If the records with duplicate keys should not be in 
the table, use REPAIR DELETE to remove the erroneous rows. 
Use the RID values provided in this message as input to the 
REPAIR utility. Use the CHECK INDEX utility to check the 
validity of the resulting index. 


Problem Determination: Use REPAIR LOCATE RID DUMP to 
view the records with duplicate keys. SQLSELECT may fail due 
to the inconsistent index. Use CHECK INDEX to check the 
validity of the index. 


DSNU342I =csect-name ERROR LOADING INDEX, ERROR = 


Xreason-code, INDEX = index-name 


Explanation: The LOAD or REORG utility encountered a proc- 
essing error, which it could not correct, while extending the 
index identified by 'index-name'. Refer to “Section 4. DB2 
Codes” on page 4-1 for an explanation of the code given in 
'reason-code'. 


po a Internal DB2 Information a aa 
This message is issued by the following CSECT(s): DSNURBXA 


[eek ee os End of Internal DB2 Information ere) 


Severity: 8 (error) 


System Action: The building of index entries for the indicated 
index is not completed. An SVC dump of the database services 
address space is requested for diagnostic purposes. The 
extension of other indexes associated with the tables being 
loaded is attempted. Any subsequent attempt to use the index 
directly or indirectly will cause the invoker to abend. 


User Response: [if the indexed table is used by more than one 
application, the system programmer should be informed so that 
applications that insert rows into, or delete rows from, the table 
or use the index directly are inhibited until corrective action is 
taken. 


Normal corrective action would be to use the RECOVER INDEX 
utility option to reconstruct the index after the processing 


DSNU342I — DSNU344I 


problem identified by the reason code has been resolved. 
Alternatively, the index can be dropped and then created again, 
unless the index in question is the partitioning index. 


Operator Response: The table space in question might need to 
be stopped and started for utility-only processing to inhibit 
attempted application use of the defective index. 


System Programmer Response: If the index is used by more 
than one application, applications that either insert rows into, 
or delete rows from, the indexed table or use the index to 
access rows must be inhibited from executing. One way to 
accomplish this is to place the table space in question under 
utility only processing contro! via the -START and -STOP DATA- 
BASE commands until the RECOVER INDEX utility is executed. 


Alternatively, the index can be dropped. Application execution 
can then proceed, and the index can be created again (unless 
the index was the partitioning index). Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 
Refer to “Section 4. DB2 Codes” on page 4-1 to determine the 
processing error indicated by the reason code. For a dis- 
cussion of how a table can be dropped and created again, or 
what to do if a partitioning index is damaged, refer to the dis- 
cussion of LOAD processing in Section 3 (Volume 1) of Adminis- 
tration Guide. 


DSNU343! csect-name - BUILD PHASE STATISTICS. nnn 


DUPLICATE KEY ERRORS ENCOUNTERED 


Explanation: The count of duplicate key errors encountered 
during processing is 'nnn'. 


hi ~~~ Internal DB2 Information ~——_——_————S~S | 


This message is issued by the following CSECT(s): DSNURBIX, 
DSNURBXD 


[iat eee End of Internal DB2 Information Ses Fee 


Severity: 4 (warning) 


System Action: Processing continues. Records causing the 
duplicate key errors will be deleted in a subsequent phase. 


DSNU344I ~—s csecct-name - UNIQUE INDEX KEY DUPLICATES 
KEY OF INDEXED ROW AT RID errr INDEX = 
index-name TABLE = table-name RECNO = 


input-dataset-record-number RID = duprid 


Explanation: The input data set record indicated was loaded 
into table 'table-name' at RID 'duprid', but it causes a unique 
index violation for index 'index-name'. It duplicates the key 
value of a record already in the table at RID 'rrrr'. 


a aaedle internal DB2 Information ee Fe 
This message is issued by the following CSECT(s): DSNURBXA 


Do ee End of Internal DB2 Information do pene a 


Severity: 4 (warning) 


System Action: Processing continues. No index entry is 
created for the record at RID 'duprid'. The record will be 
deleted in a subsequent phase of processing. 
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csect-name UNIQUE INDEX KEY DUPLICATES KEY 
FROM INPUT DATASET RECORD iiii LOADED AT 
RID rrrr INDEX = index-name TABLE = table- 
name RECNO = recno RID = duprid 


DSNU3451 


Explanation: Input data set record ‘recno' was loaded into 
table 'table-name' at RID 'duprid', but it causes a unique 
index violation for index ‘index-name'. It duplicates the key 
value of another record in the load job: the record loaded at RID 
‘rerr' from input data set record 'iiii'. 


| Internal DB2 Information as | 
This message is issued by the following CSECT(s): DSNURBXD 


be tno End of Internal DB2 Information eee 


Severity: 4 (warning) 


System Action: Processing continues. Index entries are not 
created for either record. Both records will be deleted in a sub- 
sequent phase of processing. 


DSNU348! csect-name BUILD PHASE STATISTICS. 
NUMBER OF KEYS = nnnnannnn FOR INDEX 


index-name PART part-num 


Explanation: This message is issued by the BUILD phase of the 
RECOVER INDEX utility to report the total number of index key 
entries used to build the indicated index partition. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNURBXA 


en ee End of Internal DB2 Information Bhetoan 25e 


Severity: 0 (informational) 


System Action: This message indicates the number of index 
key entries submitted to the DB2 data manager to build the indi- 
cated index partition. Both unique and non-unique key entries 
are counted. Rejected key entries are not counted. 


User Response: The user can verify that the number reported 
is consistent with expectations. 


DSNU349I_ csect-name BUILD PHASE STATISTICS. 


NUMBER OF KEYS = nnnnnnnn FOR index-name 


Explanation: This message is issued by the BUILD phase of the 
LOAD, REORG or RECOVER INDEX utility. The message is 
repeated for each index built by the LOAD, REORG or 
RECOVER INDEX utility. It indicates the total number of index 
key entries used to build the indicated index. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNURBXA 


ee End of Internal DB2 Information eee: 


Severity: 0 (informational) 


System Action: This message indicates the number of index 
key entries that were submitted to the DB2 data manager to 
build the indicated index. Both unique and non-unique key 
entries are counted. Rejected key entries are not counted. 
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User Response: The user can verify that the number reported 
is consistent with expectations. For example, the user can 
determine if it matches the number of records loaded for the 
table indexed by the indicated index. 


DSNU3501_ _—scsect-name - EXISTING RECORDS DELETED 


FROM TABLESPACE 


Explanation: A LOAD utility execution, in which REPLACE was 
specified, has deleted all records from the specified table 
space. 


~~ Internal DB2 Information ~—————— el 
This message is issued by the following CSECT(s): DSNURELD 


| seEnd of Internal DB2 Information ___—_| 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU352I EXISTING RECORDS DELETED FROM 


TABLESPACE PARTITION x 


Explanation: A LOAD utility execution, in which PART 'x' 
REPLACE was specified, has deleted all data records from par- 
tition 'x'. Index records over partition 'x' will be deleted ina 
subsequent phase of processing. 


ae Internal DB2 Information Ee 
This message is issued by the following CSECT(s): DSNURWUT 


pie aoe, End of Internal DB2 Information _ 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU355I csect-name INDEXVAL PHASE STATISTICS - nnn 
DUPLICATE KEY ERRORS CORRECTED BY 


DELETING rrr DATA ROWS 


Explanation: This message reports the results of the 
INDEXVAL phase of the LOAD utility. Data rows which were 
added during the LOAD or RELOAD phase of this LOAD utility 
invocation have been deleted because they caused unique 
index violations in the BUILD phase. A total of 'rrr' data rows 
were deleted to correct 'nnn' unique index violations. 


Unique index violations are counted in one of two ways. An 
input data set record which has a value for a uniquely indexed 
column that duplicates a value that existed in the index prior to 
the LOAD job is counted as one duplicate key error. Two input 
data set records which have like values for a uniquely indexed 
column are counted as two unique index errors (that is, each of 
the two input data set records is in error). 


aa ane internal DB2 Information ae | 
This message is issued by the following CSECT(s): DSNURVIX 


So eats End of internal DB2 Information | 


Severity: 4 (warning) 


System Action: Processing continues. 


User Response: Compare the number of duplicate key errors 
corrected in the INDEXVAL phase to the number of duplicate 
key errors detected in the BUILD phase (reported by message. 
DSNU343)). If the counts are unequal, notify the system pro- 
grammer. 


If the counts are equal, following the LOAD utility execution, 
examine the discards file or the LOAD error summary to deter- 
mine which input data set records caused the unique index vio- 
lations. Revise the input records so they will not introduce 
duplicate values into unique indexes and reapply the input 
records to the table space. Alternatively, if appropriate, make 
the index non-unique and reapply the rejected records to the 
table space. 


System Programmer Response: If necessary, refer to Section 5 
of Diagnosis Guide and Reference for failure analysis proce- 
dures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Probiem Determination” on page X-5: 1, 
5. 


DSNU356I_ = csect-name INDEXVAL PHASE COMPLETE, 


ELAPSED TIME = hh/mm/ss 


Explanation: The INDEXVAL phase of the LOAD utility has 
completed normally. The elapsed time for the execution was 
‘hh' hours, 'mm' minutes, and 'ss' seconds. 


| Internal DB2 Information ~~ cari) 
This message is issued by the following CSECT(s): DSNURVIX 


ae End of Internal DB2 Information Pee, 


Severity: 0 (informational) 


DSNU3611_ csect-name FOREIGN KEY HAS NO PRIMARY KEY 
FOR RELATIONSHIP = r1 INPUT RECORD 


NUMBER = nnnn, RID=X'rrrr' 


Explanation: Input record 'nnnn' caused a row to be loaded 
into table ‘table’ at RID 'rrrr' with no primary key for the 
relationship with the name 'r1'. 


al: Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNURCRI 


eee End of Internal DB2 Information we etna J] 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: None required. The constraint violation 
described will be rectified later in processing. 


DSNU3631 csect-name - ENFORCE PHASE STATISTICS - 
RELATIONSHIP ri FOREIGN KEYS CHECKED =n 


CONSTRAINT VIOLATIONS ENCOUNTERED =m 


Explanation: This message provides statistics for the enforce 
phase of the load utility. For relationship 'r1', the number of 
foreign keys checked is 'n'. The number of constraint vio- 
lations found is 'm'. 
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eos Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNURCRI 


fe ees End of Internal DB2 Information eet eet 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU3671! csect-name - ENFORCE PHASE STATISTICS - n 


ROWS DELETED FROM TABLE t 


Explanation: This message reports the results of the ENFORCE 
phase of the LOAD utility. Data rows added during the RELOAD 
phase of the LOAD utility have been deleted because they con- 
tained foreign keys which did not have a a corresponding 
primary key. A total of 'n' data rows were deleted from table 

i ae 

Primary errors may cascade and remove additional records. 


The count is the sum of both primary and secondary constraint 
violations. 


| Internal DB2 Information Sa 
This message is issued by the following CSECT(s): DSNURRRI 


Vesa Stee End of Internal DB2 Information eee ees a 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Determine why no primary key exists for the 
deleted record. 


Problem Determination: Ali primary errors are accompanied 
by a DSNU361i message which identifies the relationship and 
input record which does not have a primary key value. The 

report phase wili report all secondary errors and indicate the 
primary error record which caused this record to be deleted. 


The relevant parent table can be found by querying the 
SYSIBM.SYSRELS catalog table. The relevant columns can be 
found by querying the SYSIBM.SYSFOREIGNKEYS catalog 
table. 


DSNU369I_ _—scsect-name - ENFORCE PHASE COMPLETE, 


ELAPSED TIME = hh/mm/ss 


Explanation: The ENFORCE phase of the LOAD utility has com- 
pleted normally. The elapsed time for the execution was 'hh' 
hours, 'mm' minutes, and 'ss' seconds. 


eae ree es Internal DB2 Information fete 
This message is issued by the following CSECT(s): DSNURENF 


[eee End of Internal DB2 Information Sore 


Severity: 0 (informational) 


DSNU370!I_ _—scsect-name - THE LOCAL FORMAT OPTION HAS 
BEEN USED WITH A DATE OR TIME AND NO 


LOCAL EXIT HAS BEEN INSTALLED. 


Explanation: The Installation Application Programming 
Defaults Panel indicated that an exit for date or time was sup- 
plied, but the exit supplied by DB2 was not replaced. 
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i = Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUCBRK, 
DSNURWUT 


[| End of Internal DB2 Information _____ | 


Severity: 8 (error) 
System Action: The statement cannot be executed. 


User Response: Contact the system programmer about instal- 
lation of the date or time exit. 


System Programmer Response: To replace the DB2-supplied 
exit routine, an SMP USERMOD must be applied. If an SMP 
USERMOD is undesirable, the replacement module may be 
linked into a user library either included in the MVS LINKLIST 
or concatenated to the STEPLIB in the started task JCL for 
ssnmDBM1 ('ssnm' is the subsystem name, and DSN is the 
default). 


DSNU375I_ _—csect-name DISCARD PHASE STATISTICS - nnn 


INPUT DATA SET RECORDS DISCARDED 


Explanation: Input data set records were rejected by the LOAD 
utility for one or several reasons. The rejected records have 
been placed in a discards data set. The number of records 
rejected is 'nnn'. Message DSNU399/1 summarizes the errors 
causing the records to be rejected. 


[ mea Internal DB2 Information 
This message is issued by the following CSECT(s): DSNURDNP 


[eet Ses End of Internal DB2 Information page 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Examine the LOAD error summary and decide 
which of the discarded records, if any, should be corrected and 
reapplied to the table space. 


DSNU376I csect-name DISCARD PHASE COMPLETE, 


ELAPSED TIME = hh/mm/ss 


Explanation: The DISCARD phase of the LOAD utility has com- 
pleted normally. The elapsed time for the execution was ‘hh' 
hours, 'mm' minutes, and 'ss' seconds. 


[ee Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNURDIS 


Ls End of internal DB2 Information i 


Severity: 0 (informational) 
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csect-name IMAGE COPY REQUIRED FOR 
TABLESPACE = tablespace-name PARTITION = 
part-num 


DSNU380! 


Explanation: This message is issued after: 


* ALOAD utility execution in which 'LOG(NO)' was specified 
has left the associated table space partition in an unrecov- 
erable state. 


¢ An Image Copy failure because broken page(s) have been 
detected. 


¢ A Partial Recover of a table space partition has been fin- 
ished successfully. 


An IMAGE COPY is required to establish a new base from which 
the table space partition can be recovered. Otherwise, the 
results of executing the recovery utility on that table space par- 
tition are unpredictable. 


[ — Internal DB2 Information ~~ ‘ ~ | 


This message is issued by the following CSECT(s): DSNUGSRX, 
DSNUGTER 


leashes Set! End of Internal DB2 Information Bos tte al 


Severity: 4 (warning) 


User Response: An IMAGE COPY of the associated table 
space partition should be taken. if the message is issued after 
COPY utility has failed, ail the specified error(s) must be fixed 
for the associated table space before another Image Copy is 
attempted on that table space. 


DSNU381I_  csect-name IMAGE COPY REQUIRED FOR 


TABLESPACE =tablespace-name 
Explanation: This message is issued after: 


¢ ALOAD utility execution in which 'LOG(NO)' was specified 
has left the associated table space in an unrecoverable 
state. 


¢ An image Copy failure because broken page(s) have been 
detected. 


* A Partial Recover has been finished successfully. 


An IMAGE COPY is required to establish a new base from which 
the table space can be recovered. Otherwise, the results of 
executing the recovery utility on that table space are unpredict- 
able. 


‘_— ~~~ _ Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUGSRX, 
DSNUGTER 


ete oe End of Internal DB2 Information et 


Severity: 4 (warning) 


User Response: An IMAGE COPY of the associated table 
space should be taken. If the message is issued after COPY 
utility has failed, all the specified error(s) must be fixed for the 
associated table space before another Image Copy is attempted 
on that table space. 


DSNU3901_ _ csect-name INVALID CONVERSION FOR FIELD 


cecccccc 


Explanation: The input field type for column, 'cccccccc', is 
incompatible with its data type (as found in the catalog). 


[ Internal DB2 Information ~~ : 
This message is issued by the following CSECT(s): DSNURWUF 


[era Sten oe End of Internal DB2 information eee eet 


Severity: 8 (error) 
System Action: Utility processing is terminated. 


User Response: Correct the error, and resubmit the job. Refer 
to Chapter 3 of Command and Utility Reference for compatible 
data types. 


DSNU396I_ _csect-name REPORT PHASE COMPLETE, 


ELAPSED TIME = hh/mmi/ss 


Explanation: The REPORT phase of the LOAD utility has com- 
pleted normally. The elapsed time for the execution was 'hh' 
hours, 'mm' minutes, and 'ss' seconds. 


| Internal DB2 Information te oe a 
This message is issued by the following CSECT(s): DSNURREP 


Hated castes End of Internal DB2 Information pas Fs 


Severity: 0 (informational) 


DSNU398I csect-name UNEXPECTED PROCESSING ERROR, 


REASON = X00E40318, ON TABLE tttttttt 


Explanation: When attempting to load a record into table 
‘tttttttt', an error was encountered. Refer to “Section 4. DB2 
Codes” on page 4-1 for an explanation of reason code 
*00E40318'. 


. Internal DB2 Information nies 
This message is issued by the following CSECT(s): DSNURWBF 


Dee End of Internal DB2 Information | 


Severity: 8 (error) 


System Action: If the error was caused by a resource not being 
available, a DSNT5001 message is issued. 


The utility step is abended with a system X'04E' with an abend 
reason code of '00E40318'. If a DSNT500I message is not 
issued, an SVC dump is requested. A SYSABEND dump of 
batch storage is also requested. 


The utility step is left in the stopped state. 


User Response: !f a DSNT500I message was issued, refer to its 
description under that message number in this manual. If the 


-unavailable resource becomes available, the utility step is 


restartable. 


lf a DSNT500! message is not issued, the error is an internal 
error. Notify the system programmer. 


DSNU3901 — DSNU399I 


Operator Response: An operator with SYSOPR authority can 
issue a TERM UTIL to free any held resources (this may not be 
necessary). 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DSNU3991__—scsect-name - LOAD UTILITY ERROR SUMMARY 


REPORT 


Explanation: This message summarizes errors encountered 
during the load job. Figure 3 shows the format of the report. It 
is issued only if unique index or referential constraint violations 
were detected. 


ERROR INPUT 
SEVERITY RECORD 


<discard ERROR TABLE FIELD/FANSET RELATED 
heading> TYPE NAME NAME ERROR 


idsrn <ddsrn> 


type namel name2 idsrn2 





Figure 3. LOAD UTILITY ERROR SUMMARY REPORT 


The report contains one line for each error encountered. The 
errors are ordered first by error severity and within that by 
‘idsrn'. 


The <discard heading> is either 'DISCARD RECORD' or blank, 
depending on whether discard processing is in effect. 


The 'sev' is the severity of the error reported on this line: 


Severity Type of Error Explanation 

1 Primary Primary referential! integrity 
errors and all nonreferential 
integrity errors. 

2 Secondary Secondary referential integrity 


errors (i.e., errors that result 
from a primary referential 
integrity error in an ancestor). 


The 'idsrn' is the relative record number in the input data set 
of the record causing the error reported on this line. 


The 'ddsrn' is the relative record number in the input data set 
of the record causing the error reported on this line, if discard 
processing is in effect. Otherwise, 'ddsrn' is blank. 


The 'type' is a description of the type of error reported on this 
line. It is one of the following values: 


Conversion 

Field specification 
Validation 

Part Specification 
Unexpected 

Column specification 
Referential integrity 
Duplicate key. 


The 'namet' is the name of the table for which the record 
causing the error was targeted, if such information is. pertinent 
for the type of error reported on this line. Otherwise, 'name1' 
is blank. The 'table name' field takes on non-blank vatues for 
the following error types: 


Conversion 

Validation 

Column specification 
Referential integrity (primary). 
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The 'name2' is the name of the field or fanset involved in the 
error reported on this line, if such information is pertinent for 
the type of error reported. Otherwise, 'name2' is blank. The 
‘name2' is a field name for the following types of errors: 


Conversion 
Fieid specification 
Column specification. 


The 'name2' is a relationship name for primary referential 
integrity errors. 


The 'idsrn2' is the input data set record number of a related 
error. For duplicate key errors, it gives the input data set 
record number of the record whose key is duplicated. For sec- 
ondary referential integrity errors, it gives the input data set 
record number of the record whose primary referential integrity 
error cascaded to cause this secondary error. For other types 
of errors, this field is unused. 


Severity: 4 (warning) 


System Action: Processing continues. 


csect-name IMAGE COPY COMPLETE. NUMBER 
OF PAGES = nnnnann, AVERAGE PERCENT FREE 
SPACE PER PAGE = ff.ff, PERCENT OF CHANGED 
PAGES = pp.pp, ELAPSED TIME = hh/mmiss 


DSNU400I 


Explanation: This message is issued in response to the normal 
completion of the image copy (COPY) utility. The statistics 
apply to pages included in the scope of the COPY request. This 
can either be a full table space (DSNUM(ALL)) or a partition of a 
table space (DSNUM(integer)). All the pages in the above table 
space or partition can be copied (FULL(YES)), or only the 
changed pages can be copied (FULL(NO)). 


The average percentage of free space within the copied pages 
(ff.ff) indicates the amount of change activity that can occur 
without significant impairment of reference performance. 


The percentage of changed pages (pp.pp) indicates the amount 
of change activity that has occurred since the last image copy 
or reorganization. The percentage of changed pages is 
obtained by dividing the number of changed pages by the 
number of pages scanned. Preformatted pages consisting of all 
zeros are included in the count of pages scanned. Since these 
preformatted pages are not copied to the output data set, the 
number of pages scanned will usually be larger than the 
number of pages copied. 


eee — Internal DB2 Information i are 
This message is issued by the following CSECT(s): DSNUBICO 


| End of Interna! DB2 Information _____——_S 


System Action: This message indicates the normal completion 
of the image copy utility. Processing continues to the next 
utility statement in the utility job-step, if any. If there are no 
more utility statements, the utility job-step is normally termi- 
nated, and the resources are released to their prior availability 
state. The UTILID of the utility job-step becomes available for 
reuse. 


User Response: Reported statistics could suggest that either a 
RUNSTATS or REORG utility should be applied against the nom- 
inated table space. 


Operator Response: The image copy data set identified by the 
DD card nominated in COPYDDN option is cataloged in 
SYSIBM.SYSCOPY. DB2 assumes it is now available for subse- 
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quent re-call if the need arises (for example, RECOVER utility). 
The operator should ensure that the data set can be re-called. 


Problem Determination: Calculate the number of changed 
pages by dividing the number of changed pages by the number 
of pages scanned. Include preformatted pages that consist of 
all zeros in the count of pages scanned. Since these prefor- 
matted pages are not copied to the output data set, the number 
of pages scanned will usually be larger than the number of 
pages copied. 


DSNU4021_~—s csect-name INCREMENTAL IMAGE COPY DISAL- 
LOWED FOR REQUESTED TABLESPACE, FULL 


IMAGE COPY WILL BE TAKEN 


Explanation: Only full image copies are permitted for the DB2 
maintained table spaces DSNDB01.DBD01, DSNDBO6.SYSCOPY, 
and DSNDBO1.SYSUTIL. A request for an incremental image 
copy is ignored, and a full image copy is taken. 


| Internal DB2 Information ‘ coe | 
This message is issued by the following CSECT(s): DSNUBICO 


Pesce ee End of Internal DB2 Information eee 


System Action: Table spaces DSNDB01.DBD01, 
DSNDB06.SYSCOPY, and DSNDB01.SYSUTIL require special 
handling by DB2 that precludes using incremental image 
copies. A request to take an incremental image copy of these 
table spaces is treated as a request to take a full image copy. 


User Response: In the future, use of the COPY utility against 
the requested table space should request full image copies 
(FULL(YES)). 


Be alert that the capacity of the target image copy data set may 
not be sufficient if its size was established assuming an incre- 
mentai image copy. If this condition is likely, terminate and 
then resubmit the job-step. 


DSNU403I_—scsect-name - FULL AND INCREMENTAL COPIES 
OF THE SAME TABLESPACE ON THE SAME TAPE 


DISALLOWED 


Explanation: The COPY utility has been invoked to take an 
incremental image copy of a TABLESPACE. The specified 
output data set is on a tape which contains another FULL or 
INCREMENTAL image copy of the same TABLESPACE. This is 
not allowed. 


—-—- Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUBCKD 


| End of Internal DB2 Information _ 


Severity: 8 (error) 


System Action: The utility will terminate with a return code of 
8, and will not take the image copy or update the SYSCOPY 
table. 


User Response: Change the VOLSER for the image copy 
output data set or use the MODIFY RECOVERY utility to delete 
SYSIBM.SYSCOPY records which are no longer needed for the 
same TABLESPACE and tape volume. 


Problem Determination: Use the SQL SELECT command to 
look at the SYSIBM.SYSCOPY table. If the conflicting image 
copy data sets on the output tape are no longer 


needed, use MODIFY RECOVERY to eliminate the related 
SYSIBM.SYSCOPY records. If the data sets are still needed, 
you must place the new image copy on a different tape or you 
must take a FULL image copy. 


DSNU405I_ _—csect-name INCREMENTAL IMAGE COPY DISAL- 
LOWED FOR THE REQUESTED TABLESPACE OR 


DATASET 


Explanation: An incrementa! image copy for a table space or 
data set was requested. However, a full image copy is required 
for one of the following reasons: 


e A full image copy must be taken following a LOAD or 
REORG of the table space or data set. 


e A ‘copy pending' condition has been set on for the 
requested table space or data set. 


pe- ets Internal DB2 Information ene ot 
This message is issued by the following CSECT(s): DSNUBBFR 


ee End of Internal DB2 Information Were ae 


Severity: 8 (error) 


System Action: The COPY utility completes unsuccessfully. It 
has a return code of 8. 


User Response: Terminate the COPY utility job. Then, 
resubmit the COPY utility to take a full image copy for the table 
space or data set. Refer to Chapter 3 of Command and Utility 
Reference for a discussion of COPY utility constraints. 


DSNU407I_ ~—s csect-name - DATA SET ALREADY USED FOR 


PREVIOUS IMAGE COPY 


Explanation: The COPY utility has been invoked to take an 
image copy to a data set which is a duplicate of one already 
recorded in SYSCOPY. If the specified data set is cataloged, a 
matching DSNAME exists. If the specified data set is not cata- 
loged, a matching DSNAME, DSVOLSER, and FILESEQNO 
exists. 


[ =o Internal DB2 Information oS = 
This message is issued by the following CSECT(s): DSNUBCKB 


De eee anton End of internal DB2 Information Be teal 


Severity: 8 (error) 


System Action: The utility will terminate with a return code of 
- 8, and will not take the image copy or update the SYSCOPY 
table. 


User Response: Change the name of the data set or use 
MODIFY utility to delete the old SYSCOPY record containing the 
duplicate data set. 


DSNU408i csect-name - dsn EXISTS WITH -VOLUME = vol, 
FILE SEQUENCE-NUMBER = fseq, RBA=rba, 


DATE = date, TIME =time 


Explanation: This message is issued after message DSNU4031 
to provide information about the SYSCOPY whose copied data 
set is of the same table space and on the same tape, or after 
message DSNU4071 to provide information about the duplicate 
data set which was detected during Image Copy processing. 


DSNU405I — DSNU415I 


FILE SEQUENCE NUMBER will equal 0 for copies to DASD or 
MSS, VOLUME will be (CATG) for copies of cataloged data sets. 


| Internal DB2 information | 
This message is issued by the following CSECT(s): DSNUBCKB 


————s End of internal DB2 Information ete 


Severity: 8 (error) 


System Action: The utility will terminate with a return code of 
8, and will not take the image copy or update the SYSCOPY 
table. 


User Response: Use the information provided to change the 
name of the data set or to locate the duplicate SYSCOPY record 
for deletion with the MODIFY RECOVERY utility. 


DSNU410I csect-name TABLESPACE OR DATA SET CON- 


TAINED NO CHANGED PAGES 


Explanation: An incremental image copy (COPY option 
FULL(NO)), which copies only changed pages, was requested. 
However, no changed pages were found. 


——— Internal DB2 Information a aaa 
This message is issued by the following CSECT(s): DSNUBICO 


leweat onan oa End of Internal DB2 Information eae | 


Severity: 4 (warning) 


This message reflects a warning condition that did not prevent 
subsequent processing. 


System Action: This message indicates normal completion of 
the image copy utility. Processing continues to the next utility 
statement in the utility job-step, if any. If there are no more 
utility statements, the utility job-step is normally terminated, 
and the resources are released to their prior availability state. 
The UTILID of the utility job-step becomes available for reuse. 


Because no output was produced, the SYSIBM.SYSCOPY 
catalog table remains unchanged. 


The requestor may want to determine why the apparent 
assumption that a change occurred was not true. 


Operator Response: The target copy data set identified by the 
DD card nominated by the COPY COPYDDN option was not 
required. It was not tracked in the DB2 catalog table 
SYSIBM.SYSCOPY. It need not be kept for subsequent re-call. 


DSNU4151 ~—s csect-name INVALID OUTPUT BLOCK SIZE 


SPECIFIED 


Explanation: Valid block sizes for an image copy or mergecopy 
data set are 4096, 8192, or 16384. 


| Internal DB2 Information a 1 


This message is issued by the following CSECT(s): DSNUBICO, 
DSNUBCLO 


ae es End of internal DB2 Information Beta! 


Severity: 8 (error) 


System Action: Utility processing is terminated. 
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DSNU416I — DSNU458i 


User Response: Correct the JCL statement, or use the default. 
Resubmit the request in a new utility job-step. Refer to Chapter 
3 of Command and Utility Reference for a discussion of image 
copy and work data set constraints. 


DSNU4161  csect-name THE OUTPUT IMAGE COPY DATA 


SET CANNOT BE PARTITIONED 


Explanation: The use of partitioned image copy data sets is 
restricted. The copy or mergecopy utility job that was submitted 
has a partitioned output image copy data set, specified by the 
COPYDDN DDNAME parameter. 


| ——_ [nternal DB2 Information ~~~ 


This message is issued by the following CSECT(s): DSNUBICO, 
DSNUBCLO 


a End of Internal DB2 Information eee, 


Severity: 8 (error) 


System Action: Utility processing is terminated. The image 
copy will not be taken or the merge will not be done, and the 
SYSIBM.SYSCOPY table will not be updated. 


User Response: Correct the utility job by specifying a non- 
partitioned data set as the output image copy data set. 


DSNU420!_ ~=csect-name INCORRECT SHARE LEVEL SPECI- 


FIED 


Explanation: When copying a table space that is not recover- 
able, the share level (SHRLEVEL) must be REFERENCE. 


(or Internal DB2 Information RR ee | 
This message is issued by the following CSECT(s): DSNUBICO 


eet End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Correct the SHRLEVEL to REFERENCE, and 
resubmit the COPY utility in a new utility job-step. Refer to 
Chapter 3 of Command and Utility Reference for a discussion of 
COPY utility constraints. 


DSNU454I csect-name COPY MERGE COMPLETE. NUMBER 
OF COPIES = iiiii, NUMBER OF COPIES MERGED 
= cccecc, TOTAL NUMBER OF PAGES MERGED 

= ttttt, AVERAGE DISTANCE BETWEEN PAGES = 


ddddd, ELAPSED TIME = hh/mm/ss 


Explanation: This message marks the normal completion of 


‘cecccc' indicates the number of image copies that were 
merged. The number merged can be less than the number 
found if a work data set was not specified using the 
MERGECOPY WORKDDN option. 


'ttttt' indicates the total number of pages that were merged. 
‘ddddd' is the average distance, in pages, between consec- 
utive changed pages in each incremental image copy. The 
average distance is determined across all participating copies. 
It is indicative of the usefulness of taking incremental copies 
rather than full image copies. 
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[ ae Internal DB2 Information Ge ge “| 
This message is issued by the following CSECT(s): DSNUBCLO 


ed End of Internal DB2 Information eee 


Severity: 0/4 (informational/warning) 


System Action: This message indicates the normal completion 
of the MERGECOPY utility. Processing continues to the next 
utility statement in the utility job-step, if any. If there are no 
more utility statements, the utility job-step is normally termi- 
nated, and the resources are released to their prior availability 
state. The UTILID of the utility job-step becomes available for 
reuse. 


The merged incremental copies have been consolidated either 
into a single new incremental image copy or into a new full 
image copy depending upon the MERGECOPY NEWCOPY 
option. The DB2 catalog table SYSIBM.SYSCOPY has been 
updated to reflect the results. This message may indicate that 
prior data set entries have been deleted and, consequently, that 
backup data set resources have been freed. 


The user can review the reported statistics to assess the effec- 
tiveness of performing incremental image copies. 


The user can examine the SYSIBM.SYSCOPY catalog table to 
review the incremental and full image copies that are subject to 
DB2 re-call. 


The full or incremental! image copy data set identified by the DD 
card nominated in the COPYDDN option has been cataloged in 
SYSIBM.SYSCOPY. DB2 assumes that the image copy data set 
is now available for subsequent re-call. Ensure that the data 
set can be recalled. 


DSNU4581_ _—csect-name NO IMAGE COPIES TO MERGE 


Explanation: This message is issued in response to a 
MERGECOPY request. The MERGECOPY utility was invoked to 
merge existing incremental image copies. However, in 
checking the DB2 catalog table SYSIBM.SYSCOPY, no incre- 
mental image copies were found. 


| -. Internal DB2 Information ~~~ nee: | : 
This message is issued by the following CSECT(s): DSNUBCLO 


[ie ees End of Internal DB2 Information ee 


Severity: 4 (warning) 


A severity 4 condition is given to alert the invoker that proc- 
essing did not proceed as defined. However, processing is pro- 
ceeding; nothing was encountered that would invalidate further 
processing. 


Refer to “Utilities Message Severity Codes” on page 3-155 for 
information about utilities severity codes in general. 


System Action: This message indicates the completion of the 
MERGECOPY utility. Processing continues to the next utility 
statement in the utility job-step, if any. If there are no more 
utility statements, the utility job-step is normally terminated, 
and the resources that were held become available for REFER- 
ENCE processing. The UTILID of the utility job-step becomes 
available for reuse. 


The requestor may want to determine why the assumption that 
incremental copies existed was not true. 


Operator Response: The target copy data set identified by the 
DD card nominated by the MERGECOPY COPYDDN option was 
not required. It was not tracked in the DB2 catalog table 

SYSIBM.SYSCOPY. It need not be kept for subsequent re-call. 


csect-name IMAGE COPIES INCONSISTENT. 
MERGECOPY REQUEST REJECTED 


DSNU4601 


Explanation: MERGECOPY was requested for an entire table 
space. However, the most recent image copy for the associated 
table space was on the data set level. In addition, if the associ- 
ated table space was partitioned, this might indicate that any or 
all of its partitions were being reorganized or loaded without 
logging after the MERGECOPY starting point. The MERGECOPY 
starting point is the most recent FULL IMAGE COPY for the 
entire table space. 


[ 4 internal DB2 Information 
This message is issued by the following CSECT(s): DSNUBCLO 


{ End of Internal DB2 Information eee 


Severity: 4 (warning) 


A severity 4 condition is given to alert the user that processing 
did not proceed as defined. However, processing is pro- 
ceeding; nothing was encountered that would invalidate further 
processing. 


Refer to “Utilities Message Severity Codes” on page 3-155 for 
information about utilities severity codes in general. 


System Action: This message indicates the completion of the 
MERGECOPY utility. Processing continues to the next utility 
statement in the utility job-step, if any. If there are no more 
utility statements, the utility job-step is normally terminated, 
and the resources that were held become available for REFER- 
ENCE processing. The UTILID of the utility job-step becomes 
available for reuse. 


No output was produced and the SYSIBM.SYSCOPY catalog 
table remains unchanged. 


User Response: A full image copy of the associated table 
space should be taken. However, if it is preferred that a 
recovery be done on the data set level, a MERGECOPY job 
should be submitted by specifying 'DSNUM(data set number) ' 
for each data set for which MERGECOPY is required. 


DSNU4621_~—s csect-name MERGECOPY DISALLOWED FOR 


REQUESTED TABLE SPACE 


Explanation: MERGECOPY was requested for table space 
DSNDB01.DB01, DSNDBO1.SYSUTIL, or DSNDBO3.SYSCOPY. 
MERGECOPY is not permitted for one of the following reasons: 


* Only full image copies are allowed on these 
DB2-maintained tables. 


* There is no record of the full image copies in the 
SYSIBM.SYSCOPY catalog; the copy information is in the 
DB2 tog. 


DSNU460i — DSNU473!I 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUBCLO 


re End of Internal DB2 Information oe ae 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


System Programmer Response: Refer to Section 5 (Volume 2) 
of Administration Guide for more information about 
MERGECOPY utility constraints. 


DSNU4711 = csect-name - TABLESPACE tablespace-name HAS 


PENDING STATE 


Explanation: TABLESPACE 'tablespace-name' has a PENDING 
state. This message is repeated for all table spaces in the list 
that have a PENDING state. 


a aie Internal DB2 Information PS Gl 
This message is issued by the following CSECT(s): DSNUQUIA 


Nemes End of Internal DB2 Information Soper ees 


Severity: 8 (error) 
System Action: QUIESCE processing is terminated. 


User Response: Run DISPLAY DATABASE to look at the Utility 
status byte in the DBA table for a specified PENDING state. 


Problem Determination: Refer to Section 5 (Volume 2) of 
Administration Guide for a discussion of the database recovery 
function. 


DSNU472I _=csect-name - TABLESPACE tablespace-name HAS 
WRITE ERROR RANGE OR IS IN DEFERRED 


RESTART. 


Explanation: The attempt to externalize table space 
‘tablespace-name' pages to the media has failed. 


oe ~ Internal DB2 Information ~~ 
This message is issued by the following CSECT(s): DSNUQUIA 


[a eee End of Internal DB2 information seems ses 


Severity: 4 (warning) 


System Action: QUIESCE still continues but the table space 
cannot be Image-Copied. Processing continues for all indexes 
within the table space and continues to the next table space in 
the tablespace-list, if any. 


User Response: Run DISPLAY DATABASE to determine what 
exception state, if any, would prevent Image Copy on the table 
space. 


Problem Determination: Refer to Section 5 (Volume 2) of 
Administration Guide for a discussion of the database recovery 
function. 


DSNU4731_ ~—s csect-name - UNABLE TO EXTERNALIZE 


TABLESPACE tablespace-name PAGES 


Explanation: The attempt to externalize TABLESPACE 
‘tablespace-name' pages to the media has failed. 
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DSNU4741 — DSNU478I 


| Interna! DB2 Information 
This message is issued by the following CSECT(s): DSNUQUIA 


eee ae End of Internal DB2 Information Beene 


Severity: 4 (warning) 


System Action: QUIESCE still continues but the table space 
cannot be volume-dumped. 


Problem Determination: The problem may be an I/O error. 


DSNU474I csect-name - QUIESCE AT RBA erererererer 


Explanation: The log RBA at the time of the quiesce is 
‘'rrrrrerreerr’'. This value is unique for all quiesced table spaces 
in list and will be recorded in the START-RBA column of the 
SYSCOPY catalog table entry for each quiesced table space in 
list. 


| Internal DB2 information | 
This message is issued by the following CSECT(s): DSNUQUIA 


Tig 2 eee End of Internal DB2 Information re 


Severity: 0 (informational) 


System Action: The QUIESCE utility continues its termination 
processing. 


User Response: Record this RBA value as a point for future 
recovery. 


DSNU4751_ _—s csect-name - QUIESCE UTILITY COMPLETE, 


ELAPSED TIME = tttttt 


Explanation: The message marks the normal compietion of the 
QUIESCE utility. The elapsed clock time that the QUIESCE 
utility uses is shown by 'tttttt’. 


| Se ry Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUQUIB 


Nee oe End of Internal DB2 Information Meet Hil 


Severity: 0 (informational) 


System Action: Processing continues to the next utility state- 
ment in the utility job-step, if any. If there are no more utility 
statements, the utility job-step is normally terminated, and the 
resources are released to their prior available state. The 
UTILID of the utility job-step becomes available for reuse. 


DSNU476I csect-name - INDEX index-name HAS WRITE 


ERROR RANGE OR IS IN DEFERRED RESTART 


Explanation: The attempt to externalize index 'index-name' 
pages to the media has failed. 
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| Internal DB2 Information ] 
This message is issued by the following CSECT(s): DSNUQUIA 


Rete cet St End of Internal DB2 Information et A es 


Severity: 4 (warning) 


System Action: QUIESCE stil! continues but the table space 
cannot be Image-copied. 


User Response: Run DISPLAY DATABASE to determine what 
exception state, if any, would prevent Image Copy on the table 
space. 


Problem Determination: Refer to Section 5 (Volume 2) of 
Administration Guide for a discussion of the database recovery 
function. 


DSNU477I __—scsect-name - QUIESCE SUCCESSFUL FOR 


TABLESPACE =tablespace-name 


Explanation: The QUIESCE for TABLESPACE 
'tablespace-name' and all of its indexes were successful. This 
message will be repeated for every quiesced table space in list. 


internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUQUIA 


[| Ss End of internal DB2 Information sd 


Severity: 0 (warning) 


System Action: All data and indexes held in the main buffer for 
the table space have been written out to the media if no 
message DSNU473 or DSNU479 were issued earlier. A 
SYSCOPY record of ICTYPE 'Q' has been recorded in 
SYSCOPY catalog table for the table space. The START-RBA 
value in this SYSCOPY record is unique for all table spaces in 
list. This RBA value will be printed in the message DSNU474 fol- 
lowing this message. Processing continues to the next table 
space in the table space list, if any. 


DSNU478I csect-name - INDEX iIndex-name HAS PENDING 


STATE 


Explanation: index 'index-name' has a PENDING state. This 
message is repeated for all PENDING stated indexes in a table 
space. 


| Internal DB2 Information Oe 
This message is issued by the following CSECT(s): DSNUQUIA 


letras End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: QUIESCE stops processing but continues to 
check ali table spaces and indexes for any additional tabie 
space or index that has a PENDING state. There is no update in 
SYSCOPY table for any table space in the list. 


User Response: Run DISPLAY DATABASE to look at the Utility 
status byte in the DBA table for a specified PENDING state. 


Problem Determination: Refer to Section 5 (Volume 2) of 
Administration Guide for a discussion of the database recovery 
function. 


DSNU4791_ _—scsect-name - UNABLE TO EXTERNALIZE INDEX 


index-name PAGES 


Explanation: The attempt to externalize index 'index-name' 
pages to the media has failed. 


i aa ra Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUQUIA 


edi ete, End of Internal DB2 Information inter e 


Severity: 4 (warning) 


System Action: QUIESCE still continues but the table space 
cannot be volume-dumped. 


Problem Determination: The problem may be an I/O error. 


DSNUS500I csect-name RECOVERY COMPLETE, ELAPSED 


TIME = hh/imm/ss 


Explanation: This message is issued at the normal completion 
of the RECOVER utility. The time that elapsed since the begin- 
ning of the RECOVER utility to its completion was 'hh' hours, 
‘mm' minutes, and 'ss' seconds. 


fC Internal DB2 Information ee 
This message is issued by the followirig CSECT(s): DSNUCRVO 


= End of Interna! DB2 Information eeetetat sl 


Severity: 0/4 (informational/warning) 


System Action: This message indicates the normal completion 
of the RECOVER utility. Processing continues to the next utility 
statement in the utility job-step, if any. If not, the utility job-step 
is normally terminated, and the resources held become avail- 
able for further processing. The UTILID of the utility job-step 
becomes available for reuse. 


User Response: The recovered data is now available for 
further processing. 


Operator Response: The recovered resources are available 
for further processing. 


DSNUS501! csect-name A PAGE HAS BEEN STOPPED 


DURING RECOVERY. SEE PREVIOUS DSNI012 
MESSAGE 


Explanation: This message is issued at the normal completion 
of the RECOVER utility if the data manager subcomponent 
cannot apply all the fog records for the page because of an 
inconsistent DB2 log. 


| _-:«s (nternal DB2 Information 
This message is issued by the following CSECT(s): DSNUCRVO 


{Ss End of internal DB2 Information 


Severity: 4 (warning) 


DSNU4791 — DSNUS503I 


System Action: This message indicates that the RECOVER 
utility completed normally except for the page (or pages) indi- 
cated by the previous DSNI012 message(s). The faulty log 
record was not applied, but the log RBA in the page header is 
the RBA of this log record. The data manager subcomponent 
has marked the page(s) as broken. All other pages have been 
recovered successfully. Log apply stopped at the point of the 
inconsistency in the DB2 log for that page. 


User Response: Refer to Section 4 of Diagnosis Guide and Ref- 
erence for information about using the REPAIR utility in order to 
apply changes that should have been made by the log record in 
error. Resubmit the RECOVER job, specifying 
‘PAGE(page-number) CONTINUE'. This causes data manager 
to retrieve the page from DASD and apply log records starting 
after the faulty one. 


DSNU5021 _ csect-name PAGE page number WAS NOT FOUND 


IN ANY IMAGE COPY DATA SET 


Explanation: The page specified for 'RECOVER page’ was not 
found in any image copy data set for one of the following 
reasons: 


¢ The was no image copy since the last REORG or LOAD of 
the table space. 


¢ One or more image copy data sets were found, but none 
contained the page. 


¢ The image copy data set that may have contained the page 
yielded an error on 'open' or ‘read’. 


This is an informational message only. !t does not indicate ter- 
mination of processing. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUCRVO 


eet End of Internal DB2 information Ceres | 


Severity: 0 (informational) 


System Action: The RECOVER utility continues processing if 
either of the following two conditions is true. 


¢ A 'LOAD(YES)' or 'REORG LOG(YES)' record is found in 
the SYSCOPY table. The page is reset and recovered from 
the log, starting at the log RBA recorded in the SYSCOPY 
record for that event. 


¢ A full image copy data set is found, and the number of the 
requested page is higher than the last page in the data set. 
In this case, the assumption is that the page was inserted 
after the image copy was made. The page is reset and 
recovered from the log, starting at the log RBA recorded in 
the SYSCOPY record for the image copy data set. 


If neither of the above conditions is true, the utility issues the 
message DSNUSO6I and terminates with return code 8 (error). 


DSNU503i  csect-name PAGE page-number IS WITHIN PHYS- 


ICAL ERROR RANGE 


Explanation: The page specified for 'RECOVER page’ is within 
the physical error range of the table space partition or data set. 
‘RECOVER page' cannot be effective in this case, because the 
page would still be within the physical error range and there- 
fore inaccessible to the user. 
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DSNU504!1 — DSNU508I 


———— Internal DB2 Information 2 
This message is issued by the following CSECT(s): DSNUCRVO 


[snd of Internal DB2 Information _____——_ 


Severity: 8 (error) 


System Action: The RECOVER utility terminates with return 
code 8. No changes are made to the table space. 


User Response: Resubmit the RECOVER utility specifying 
‘error range’. 


DSNU5041 ~~ csect-name MERGE STATISTICS, NUMBER OF 
COPIES = cc, NUMBER OF PAGES MERGED = 
nnannn, ELAPSED TIME = hh/mm/ss 


Explanation: This message is issued at the completion of the 
MERGE process for the MERGECOPY or RECOVER utility. The 
message indicates the number of image copies currently proc- 
essed ('cc') and the total number of pages that were merged 
('nnnnnn'). The same page can be obtained from more than 
one incremental image copy. MERGE is repeated for 
MERGECOPY if all of the input image copy data sets cannot be 
allocated and a temporary work data set has been specified. 


For the RECOVER utility, MERGE is executed whether or not 
there are incremental image copies participating. In this case, 
the number of copies ('cc') is one. 


The elapsed time of the MERGE is ‘hh/mm/ss', hours, minutes, 
and seconds, respectively. 


[ 7 Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUBCLO 


———— End of Internal DB2 Information es 


System Action: The MERGECOPY or RECOVER utility con- 
tinues processing; this message is for information only. 


User Response: The statistics are indicative of the processing 

' required. For MERGECOPY, it could indicate that next time 
more input image copy data sets should be allocated. For 
example, if there was more than one MERGE pass then this 
message will be issued more than once. For both MERGECOPY 
and RECOVER, it could indicate that more frequent invocation 
of MERGECOPY is appropriate. 


DSNUS505I _csect-name PAGE page-number IS BEYOND END 


OF TABLESPACE 


Explanation: The page specified for ‘RECOVER page’ is 
beyond the end of table space. 


| Internal DB2 Information ——— ‘| 
This message is issued by the following CSECT(s): DSNUCRVO 


er, End of Internal DB2 Information eke ie 2d 


Severity: 8 (error) 


System Action: The RECOVER utility terminates with return 
code 8. No changes are made to the table space. 
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User Response: Resubmit the RECOVER utility with the correct 
page specified. 


DSNUSO6I _csect-name ALLOCATION OR OPEN FAILED FOR 


IMAGE COPY DATA SET. DSNAME = data-set- 
name. 


Explanation: The RECOVER utility attempted to use the indi- 
cated full or incremental image copy data set. The attempt was 
unsuccessful, because an allocation or open failure occurred. 
This message is informational only. It does not indicate termi- 
nation of processing. 


fo internal DB2 Information ~~~ | 
This message is issued by the following CSECT(s): DSNUBCL5 


ioe ee End of Internal DB2 Information a 


Severity: 0 (informational) 


System Action: The RECOVER utility continues processing, 
searching for a prior image copy data set. 


DSNU5071 csect-name NO USABLE BACKUP FOR RECOVER 


Explanation: The RECOVER utility determined that a backup 
was required but not found. The utility encountered one of the 
following situations: 


¢ An error occurred while processing the oldest available full 
image copy data set. This might be the only full image copy 
data set available. 


¢ While scanning backward through the SYSCOPY table, a 
LOAD LOG(NO) or REORG log(NO) record type was found. 


Any of the following is acceptable as a backup: 
e A full image copy. 
¢ ALOAD LOG(YES). 
¢ A REORG LOG(YES). 


e For RECOVER PAGE, an incremental image copy that con- 
tains the specified page. 


¢ A '‘norecord found' return from the first request for a 
SYSCOPY record indicates that the object was entirely pop- 
ulated by 'inserts'. The object will be recovered from the 
DB2 log if its entire history lies within the scope of the log, 
that is, archive fog data sets containing updates for the 
object have not been deleted. 


‘i internal DB2 Information tal 
This message is issued by the following CSECT(s): DSNUCRVO 


be ee End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: The RECOVER utility terminates. 


User Response: Re-create the object that was to be recovered. 


DSNUSO8!I_ _scsect-name - IN FALL BACK PROCESSING TO 


PRIOR FULL IMAGE COPY 


Explanation: The RECOVER utility could not allocate the most 
recent full image copy data set. The prior full image copy will 
be used. 


fee ~ Internal DB2 Information ~~~ aires | 
This message is issued by the following CSECT(s): DSNUBCLO 


Se ews End of Internal DB2 Information etx Sate 


System Action: The RECOVER utility continues processing, 
searching for the prior image copy. 


DSNUS5091_ ~—s csect-name - NO ERROR RANGE TO RECOVER 


Explanation: The RECOVER utility was invoked to recover 
existing ERROR RANGE. However, no ERROR RANGE was 
found. 


iii Internal DB2 Information NS tb 
This message is issued by the following CSECT(s): DSNUCRVO 


eres End of internal DB2 Information hires eats 


Severity: 4 (warning) 


System Action: This message indicates the completion of 
RECOVER ERROR RANGE utility. Processing continues to the 
next utility statement in the utility job-step. If there are no more 
utility statements, the utility job-step is normaliy terminated. 


DSNUS101. = csect-name NO GOOD FULL IMAGE COPY DATA 


SET FOR RECOVERY 


Explanation: It is not possible to locate a good image copy 
data set from which to recover. Either no back level image 
copy exists, or an I/O error occurred while reading the back 
level image copies. The return code that accompanies this 
message will be 0 or 8. The return code is 0 if a full image copy 
is not found in the SYSCOPY table the first time. The RECOVER 
utility will continue to recover from the log. The return code is 8 
if the RECOVER utility is in fall back mode and a full image copy 
is not found in the SYSCOPY table. In this case, further utility 
processing is terminated. 


a ~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUCRVO, 
DSNUBCLO 


[hoeags went 2 End of Internal DB2 Information eee es 


Severity: 0 (informational) or 8 (error) 


System Action: If the return code is 0, processing continues. If 
the return code is 8, further utility processing is terminated. 


User Response: Notify the system programmer if the return 
code is 8. If the return code is 0, no action is required. 


Operator Response: [f the return code is 8, the table space in 
question should be started for utility-only processing (if it is not 
in this state already) until corrective action is taken. If the 
return code is 0, no action is required. 


System Programmer Response: If the return code is 8, the data 
must be repaired so that an image copy can be taken. An 
internal error may be involved, and system support may be 
required. If the return code is 0, no action is required. Refer to 
Section 5 (Volume 2) of Administration Guide for a discussion of 
database recovery procedures. 


DSNU509!1 — DSNU514I 


DSNU5121_ csect-name DATA SET LEVEL RECOVERY IS 


REQUIRED 


Explanation: Recovery was requested for an entire table 
space. However, the most recent image copy for the associated 
table space was on a data set level. The table space must be 
recovered on a data set level. 


oe Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUBCLO 


ee ae End of Internal DB2 Information tee See ed 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: Terminate the current RECOVER job. Then, 
submit a RECOVER job by specifying 'DSNUM(data set 
number) ' for each data set for which recovery is required. 
Refer to Chapter 3 of Command and Utility Reference for a dis- 
cussion of RECOVERY utility constraints. 


DSNU513I csect-name RECOVER UTILITY APPLYING 


UPDATES FROM DB2 LOG. CURRENT LOG RBA 
RANGE IS xxx TO yyy 


Explanation: The RECOVER utility is in the process of applying 
updates from the DB2 log. 'xxx' and 'yyy' are the start and 
end log RBAs of the next range to be processed. 


| ~~ Internal DB2 Information — = 
This message is issued by the following CSECT(s): DSNUCRVL 


[eee ea End of internal DB2 Information Boke al 


Severity: 0 (informational) 
System Action: RECOVER processing continues. 


User Response: Refer to Section 5 (Volume 2) of Adminis- 
tration Guide for a discussion of database recovery procedures. 


DSNU514! csect-name RECOVERY DATA DOES NOT 
PERMIT TABLE SPACE RECOVERY OF 


TABLESPACE tablespace-name DSNUM dsnum 


Explanation: Recovery was requested for an entire table 
space. However, the most recent activity on the entire table 
space was a REORG LOG (NO) or a LOAD LOG (NO). If full 
image copies have been taken at the data set level since then, 
recover the table space on the data set level. 


| — {nternal DB2 Information ~~ eae 


This message is issued by the following CSECT(s): DSNUBCR2, 
DSNUCLCK 


ees End of Internal DB2 Information | 


Severity: 8 (error) 


System Action: RECOVER compietes unsuccessfully with a 
return code of 8. 
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DSNU515I — DSNU519I 


User Response: Submit a recover job by specifying DSNUM 
(data set number) for each data set requiring recovery. Refer 
to Chapter 3 of Command and Utility Reference for a discussion 
of RECOVERY utility constraints. 


DSNUS5151 csect-name THE IMAGE COPY DATA SET dsn 
WITH DATE = icdate AND TIME = ictime !S PARTIC- 


IPATING IN RECOVERY 


Explanation: This message is issued by the RECOVER utility 
for each participating image copy data set when it has opened 
the data set and is about to begin the rebuiid process. If an 
error occurs while processing, the full image copy data set and 
the utility fall back to a previous full image copy. The message 
will be repeated for the new configuration of data sets. 


This message is routed to SYSOUT. 


| Internal DB2 Information ——— | 


This message is issued by the following CSECT(s): DSNUBCLO, 
DSNUBCL5 


es End of Internal DB2 Information eee 


Severity: 0 (informational) 
System Action: RECOVER processing continues. 


User Response: Refer to Chapter 3 of Command and Utility 
Reference for a discussion of RECOVERY utility constraints. 


DSNU516I csect-name NO FULL IMAGE COPY AFTER LOAD 
LOG(NO) OF TABLESPACE tablespace-name 


DSNUM dsnum 


Explanation: RECOVERY was requested for a data set of a 
table space. However, no full image copy was taken after the 
table space was LOADed or REORGed without logging. The 
table space is in an unrecoverable state. 


[ oo _ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUBCR2, 
DSNUCLCK 


tee End of Internal DB2 Information et ed 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: The associated data set is in an unrecover- 
able state. Notify the system programmer for corrective action. 


System Programmer Response: The data must be repaired so 
that a full image copy can be taken. Refer to Section 5 (Volume 
2) of Administration Guide for a discussion of database 
recovery procedures. 


DSNU5171_ —csect-name - SYSCOPY RECORD DELETED BY 
MODIFY UTILITY. DSN =dsn, VOL = SER =nnn, 


FILESEQNO = fff 


Explanation: This message is repeated for each volume of a 
multivolume data set that is deleted. 
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The variables have the following meanings: 


dsn The name of the image copy data set whose record 
was removed from the SYSCOPY table by the 
MODIFY utility. 

nan The serial number of the volume containing the data 
set. 

fff The tape file sequence number. It will be zero for 
DASD data sets. 


so Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUMDEL 


Ls End of Internal DB2 Information 


Severity: 0 (informational) 


System Action: The MODIFY utility continues its termination 
processing. 


System Programmer Response: Because DB2 no longer has 
any knowledge of the image copy data set, you may delete it 
and reuse the space. If the last full image copy was deleted, 
ensure that another one is taken as soon as possible. 


DSNU518I csect-name PAGE page-number IS A BROKEN 


PAGE 


Explanation: A broken page, ‘page number', was detected 
during execution of an image copy utility. The copy step is ter- 
minated and the broken page is not copied to the output data 
set. 


a ~ Internal DB2 Information ~~ 
This message is issued by the following CSECT(s): DSNUBBFR 


fe End of Internal DB2 information ee eee 


Severity: 8 (error) 


System Action: COPY utility completes successfully with a 
return code of 8. 


User Response: The associated data set is in an unrecover- 
able state. Notify the system programmer for corrective action. 


System Programmer Response: Use either the RECOVER, 
RECOVER PAGE, or REPAIR utility to correct the broken page. 
Refer to Section 5 (Volume 2) of Administration Guide and 
Section 4 of Diagnosis Guide and Reference for additional infor- 
mation. 


DSNU5191 = csect-name TOCOPY DATA SET NOT FOUND 


Explanation: The data set specified with the keywords 
TOCOPY, TOVOLUME, or TOSEQNO cannot be found in the 
SYSCOPY table for the object to be recovered. 


This may be caused by a mismatch in granularities. Ifthe 
RECOVER specifies a particular DSNUM, the data set specified 
with the TOCOPY keyword may be for an image copy of this 
DSNUM or of the entire table space. However, if the RECOVER 
is for the entire table space, the specified data set must be for 
an image copy of the entire table space. 


This may also be caused if TOVOLUME is specified for a cata- 
loged data set. 


oe Internal DB2 Information ne | 
This message is issued by the following CSECT(s): DSNUBCLO 


les teoeeae! End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: RECOVER processing is terminated. 


User Response: Correct the input and resubmit the RECOVER 
job. 


DSNU5211_ _—csect-name - RECOVER UTILITY FAILED. UNABLE 


TO READ REQUIRED LOG RECORDS. 


Explanation: RECOVER was requested for a table space or a 
data set of a table space. An attempt was made to apply 
changes from the DB2 log but the necessary log records could 
not be read from the log data set. This message is accompa- 
nied by DSNIOO7I. 


[~ oY 4 Internal DB2 information | 
This message is issued by the following CSECT(s): DSNUCRVL 


eee End of Internal DB2 Information eee el 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: Consult the system programmer for corrective 
action. 


Operator Response: Provide the console listing of the 
DSNI007! message for the system programmer. 


System Programmer Response: Run Print Log Utility. This 
may be run with DB2 up or down. Find the data set that con- 
tains the requested RBA from the output of Print Log. 


Problem Determination: If no listed data set contains the 
required RBA, one of the following might have occurred: 


¢ The data set was deleted from the bootstrap data set by a 
run of the Change Log Inventory utility. Rerun the utility to 
insert the missing data set name. DB2 must be down to run 
this utility. 


¢ The bootstrap data set (BSDS) has been damaged. The 
BSDS must be restored from the dump that occurred with 
the most recent archive log data set. Run the Change Log 
Inventory to supply changes that occurred during and after 
the last off-load operation. Changes can be determined 
from the operator’s console listing. 


If a listed log data set contains the required RBA, this message 
is preceded by one or more error messages from the log 
manager (DSNJ). See these messages for appropriate action. 


DSNU5221_ ~=csect-name UNABLE TO OBTAIN ALTERNATE 


TRACK. RETURN CODE = return-code 


Explanation: ERROR RANGE was specified on the RECOVER 
command. RECOVER could not obtain alternate tracks for all 
the bad records encountered within the error range. No 
recovery action was taken. 


DSNU521I — DSNU524I 


[ Peet Internal DB2 Information ; | 
This message is issued by the following CSECT(s): DSNUCRVO 


aca rer End of Internal DB2 Information ee 


Severity: 8 (error) 


System Action: Because the RECOVER utility could not honor 
the ERROR RANGE request, no recovery activity was taken. 
The nominated table space is in the same state as it was prior 
to executing the RECOVER utility. Further utility processing is 
terminated. 


User Response: If the cause of the alternate track failure can 
be fixed, resubmit the job. Otherwise, resubmit the job without 
the ERROR RANGE keyword. Refer to Section 5 (Volume 2) of 
Administration Guide for a discussion of recovering databases. 


DSNU5231_~_—scsect-name - RECOVER UTILITY FAILED. NO 
FULL IMAGE COPY WAS AVAILABLE AND THE 
FIRST LOG RECORD WAS NOT THE REQUIRED 


INITIALIZATION RECORD. 


Explanation: RECOVER was requested for a table space or a 
data set of a table space and no image copy was available. 
Recovery was attempted from the log and failed due to missing 
data set initialization records. Specifically, the log records 
which format space map and header pages were missing. 


[ ages Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUCRVL 


{ End of internal DB2 Information ae 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: The associated data set has been reset to an 
empty state. Notify system programmer for corrective action. 


System Programmer Response: Use the problem determi- 
nation information given below to determine if a user error has 
occurred. If possible, correct the error and resubmit the 
RECOVER utility job for this table space or data set. Refer to 
Section 5 (Volume 2) of Administration Guide for a discussion of 
possible recovery procedures. 


Problem Determination: This message was preceded by 
message DSNU5131 which identifies the log RBA range being 
applied. Run Print Log utility for the table space in question 
over the indicated log RBA range. 


This will show what log records are present and may assist in 
determining if a log data set has been damaged or deleted, or if 
the BSDS has been damaged. If damage to table space 
DSNDB01.SYSLGRNG is suspected, recover it and attempt the 
earlier failing recovery again. 


DSNU524!_ ~_—scsect-name INVALID DATA SET NUMBER 


Explanation: The DSNUM keyword specified an invalid data set 
number for the named database and table space. 
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DSNU5251I — DSNU530I 


ir sar Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUBBFR, 
DSNUCRVO 


Poe ee wed End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: Further utility processing is terminated. 


User Response: Correct the data set number or database/table 
space names, and resubmit the COPY or RECOVER request in a 
new utility job-step. Refer to Chapter 3 of Command and Utility 
Reference for a description of the COPY or RECOVER options. 


DSNU5251 _csect-name RECOVERY DATA DOES NOT PERMIT 
TABLESPACE RECOVERY OF TABLESPACE 


tablespace-name DSNUM dsnum 


Explanation: Recovery was requested for an entire table 
space. However, either the table space or a partition of the 
table space was partially recovered (TOCOPY or TORBA was 
specified) foliowing the last full image copy of the table space. 


Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUBCR2, 
DSNUCLCK 


Ls End of internal DB2 Information 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: Terminate the current RECOVER job. Then, 
try to submit the RECOVER job with 'dsnum' specified for each 
data set for which recovery is required. Refer to Chapter 3 of 
Command and Utility Reference for a discussion of database 
recovery utility constraints. 


DSNUS26I_ _csect-name - NO FULL IMAGE COPY AFTER 
PARTIAL RECOVERY OF TABLESPACE 


tablespace-name DSNUM dsnum 


Explanation: RECOVERY was requested for a data set of a 
table space. However, an earlier RECOVER was specified with 
TOCOPY or TORBA and no subsequent image copy has been 
taken to establish a base for recovery. The table space is ina 
nonrecoverable state. 


oe ~~ Internal DB2 Information ~~ 


This message is issued by the following CSECT(s): DSNUBCR2, 
DSNUCLCK 


| End of Internal DB2 Information eres 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: The associated data set is in a nonrecover- 
able state. Consult the system programmer for corrective 
action. 


3-194 DB2 Messages and Codes 


System Programmer Response: RECOVER TOCOPY or TORBA 
may be used to force recovery to an earlier point in time. 
DSN1COPY may be used to restore to an earlier image copy. 
Refer to Section 5 (Volume 2) of Administration Guide for a dis- 
cussion of database recovery procedures. 


DSNU5271 csect-name DB2 OBJECT RECOVERED TO AN 


INDETERMINATE POINT 


Explanation: The image copy data set specified with the 
TOCOPY keyword of the RECOVER utility was for an image copy 
made with the SHRLEVEL CHANGE option. In this mode, 
changes may have been made to the object while image copy 
was in progress. If a change was made to a page before image 
copy processed the page, the update will be in the copy data 
set. If a change was made to a page after image copy proc- 
essed it, the change will not appear in the copy data set. The 
data set may contain partial updates from some transactions. 


[= 7 = Internal DB2 Information a ees 
This message is issued by the following CSECT(s): DSNUBCLO 


Peete See End of Internal DB2 Information a ee 


Severity: 4 (warning) 
System Action: The utility terminates normally. 


User Response: Based on the explanation above, determine if 
the recovery is satisfactory. Refer to Section 5 (Volume 2) of 
Administration Guide for a discussion of database recovery 
procedures. 


DSNUS529I_—scsect-name INVALID SPECIFICATION OF TORBA 


= XXX 


Explanation: 'xxx' is the log RBA specified for the RECOVER 
utility TORBA keyword. The RBA is not within the scope of the 
log. 


i ~ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNUCBFW 


ere End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: The RECOVER utility terminates with a return 
code of 8 without making any changes to the object to be recov- 
ered. If the table space is storage group defined, it has not 
been reset. 


User Response: Correct the input and resubmit the job. Refer 
to Section 5 (Volume 2) of Administration Guide for a discussion 
of database recovery procedures. 


Problem Determination: The listing produced by the Print Log 
Map utility will show the current extent of the DB2 log. 


DSNUS30I_ _csect-name DATA SET ALREADY USED FOR PRE- 


VIOUS IMAGE COPY 


Explanation: One or more of the recovery keywords TOCOPY, 
TOVOLUME or TOSEQNO were specified and more than one 
data set was found which satisfied these criteria. 


fo Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUBCLO 


Lo End of Internal DB2 Information eee | 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: Two or more DSNU5311 messages will follow 
this message providing more information about each duplicate 
data set. Select the correct data set from the DSNU531!I mes- 
sages and rerun the RECOVER job specifying a unique combi- 
nation of TOCOPY, TOVOLUME and TOSEQNO. 


DSNUS5311 csect-name - dsn EXISTS WITH - VOLUME = vol, 
FILE SEQUENCE NUMBER =fseq, RBA=rba, 


DATE = date, TIME = time 


Explanation: This message is issued two or more times to doc- 
ument the duplicate data sets detected by the RECOVER utility 
during TOCOPY processing. See the explanation for message 
DSNUS530I. 


are internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUBCLO 


Uae eee End of Internal DB2 Information en | 


Severity: 8 (error) 


System Action: RECOVER completes unsuccessfully with a 
return code of 8. 


User Response: Use the information provided in all of the 
DSNU531I messages to determine the correct data set for this 
recovery. 'rba', 'date' and 'time' are provided for each data 
set to assist in the selection. The DSNU5311 message for the 
data set you select will provide the correct 'vol' and 'fseq' 
values to be specified on the TOVOLUME and TOSEQNO 
keywords respectively. Rerun the RECOVER job specifying 
TOCOPY and TOVOLUME(vol). Include the TOSEQNO(fseq) 
keyword if it is necessary to distinguish a unique data set. 


DSNU5321 csect-name - RECOVER DATABASE database 


TABLESPACE tablespace DSNUM dsnum START. 


Explanation: This message is used to separate the RECOVER 
messages for different table spaces when there is more than 
one table space to be recovered by a single RECOVER job. 


This message is routed to SYSPRINT. 


Sa Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUBCLO, 
DSNUCLBD 


ae ee End of Internal DB2 Information Se el 


Severity: 0 (informational) 


System Action: RECOVER processing continues. 


DSNU5311 — DSNU535I 


DSNU5331 = csect-name - DUPLICATE TABLESPACE NAMES 


EXIST IN THE TABLESPACE-LIST 


Explanation: This message will be issued by the RECOVER 
utility when a duplicate table space/partition of a table space 
was found in the table space-list of a RECOVER table space-list 
job. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUCLCK, 
DSNUCRVO 


Po tes End of Internal DB2 Information id 


Severity: 8 (error) 
System Action: The utility job terminates. 


User Response: Correct the table space-list and resubmit the 
job. 


DSNU534I ~ csect-name - TORBA IS NOT A QUIESCE POINT. 


Explanation: This message will be issued by the RECOVER 
utility when it determines that a table space set is being recov- 
ered through a RECOVER table space-list TORBA job and it is 
not being recovered to a quiesce point. (That is, not all table 
spaces in the table space set have a ICTYPE= 'Q' SYSCOPY 
catalog table entry which have the same RBA as either the one 
specified in the TORBA field or any table space in the set con- 
taining a dependent table with a referential constraint which 
was defined after that quiesce point.) 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUCLVE 


[Deis et, End of Internal DB2 Information ee 


Severity: 4 (warning) 


User Response: User should recover the table space set toa 
quiesce point. If the table space set is consistent, the user can 
use REPAIR NOCHECKPEND or START DATABASE FORCE to 
reset the CHECK PENDING state. 


DSNU535I csect-name - FOLLOWING TABLESPACES 


RECOVER TO A QUIESCE POINT 


Explanation: This message wil! be issued by the RECOVER 
utility when it determines that a table space set is being recov- 
ered to a quiesce point. All table spaces in the table space set 
will be listed after this message heading. 


[ —— _ Internal DB2 Information _ "Si 
This message is issued by the following CSECT(s): DSNUCLVE 


ee ees End of Internal DB2 Information oe 2 tae | 


Severity: 0 (informational!) 


System Action: No action is taken. 
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DSNU536I — DSNU555I 


DSNUS536I _csect-name - RELATIONSHIP r ON TABLE t 


CREATED AFTER QUIESCE POINT. 


Explanation: The relationship named 'r' was created on the 
dependent table, 't', after the quiesce point used for recovering 
to a point intime. The table space in which 't' resides is set to 
CHECK PENDING beginning with the first record of 't'. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUCRVA 


ee End of Internal DB2 Information fee 


Severity: 4 (warning) 
System Action: No action is taken. 


User Response: Refer to Section 3 (Volume 1) of Adminis- 
tration Guide for the failure analysis procedure for the CHECK 
PENDING state. 


DSNU537I1_ _—scsect-name - DIRECTORY OR CATALOG 
TABLESPACE IS NOT ALLOWED IN THE 


TABLESPACE-LIST 


Explanation: This message is issued by the RECOVER utility 
when a directory or catalog table space is found in the 
tablespace-list of a RECOVER tablespace-list job. When recov- 
ering the catalog and directory, a hierarchy of dependencies 
determines the order of recovery. They cannot be recovered in 
the same invocation by using RECOVER tablespace-list. 


| Internal DB2 Information <—- 


This message is issued by the following CSECT(s): DSNUCLCK, 
DSNUCRVA 


a End of internal DB2 Information ee eA 


Severity: 8 (error) 
System Action: The utility job terminates. 


User Response: Remove the directory and catalog table space 
names from the tablespace-list and recover them individually in 
the order documented in Section 5 (Volume 2) of Administration 
Guide. Then submit the RECOVER tablespace-list job again with 
the rest of the table spaces on the list. 


DSNU5401_ ~—s csect-name DYNAMIC ALLOCATION FOR DATA 
SET data-set-name WILL WAIT FOR UNIT TO 


BECOME AVAILABLE 


Explanation: A request to dynamically allocate a data set fora 
BATCH UTILITY job was refused because a unit was not avail- 
able. The request was repeated after setting an indicator in the 
dynamic allocation parameter list to cause the job to wait until a 
unit becomes available. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUBCDA 


ete es End of Internal DB2 Information ee 


3-196 DB2 Messages and Codes 


Severity: 0 (informational) 


System Action: Processing continues after a unit becomes 
available and is allocated. 


DSNU550! csect-name INDEX NAME = index-name IS EMPTY 


Explanation: While attempting to RECOVER the indicated 
index, it was determined that the table upon which the index is 
based is empty. 


| —— Internal DB2 Information mee 
This message is issued by the following CSECT(s): DSNUCRUL 


eee Sees End of internal DB2 Information Pete ee ae | 


Severity: 4 (warning) 


System Action: Utility processing proceeds to the next utility 
request, if any. 


DSNU551I csect-name INDEX NAME = index-name 


PART = part-num IS EMPTY 


Explanation: While attempting to RECOVER the indicated index 
partition, it was determined that the partition upon which the 
specified index partition is based is empty. 


: Internal DB2 Information | 
This message is issued by the following csect(s): DSNUCRUL 


Liat eae End of Internal DB2 Information Site ee aad 


Severity: 4 (warning) 


System Action: Utility processing proceeds to the next utility 
request, if any. 


DSNUS554I_ _—scsect-name - DUPLICATE INDEX NAMES EXIST IN 


THE SPECIFIED INDEX NAME LIST 


Explanation: When attempting to CHECK or RECOVER the indi- 
cated indexes, it was determined that duplicate index names 
were specified in the index name list. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKINT 


ren End of Internal DB2 Information | 


Severity: 8 (error) 
System Action: The utility job terminated. 


User Response: Correct the index-name(s) in the index name 
list and resubmit the job. 


DSNU555I_ _—csect-name UNLOAD PHASE STATISTICS, 


NUMBER OF RECORDS = xxxx 


Explanation: This message is issued at the normal completion 
of the UNLOAD phase of the RECOVER INDEX utility. It gives the 
number of records that were unloaded (xxxx) for the specified 
table space. 


| 


os Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNUCRUL 


[eSecee ee End of Internal DB2 information eee 


Severity: 0 (informational) 


DSNUS5581_ _—scsect-name ALL INDEXES OF TABLESPACE = 


tablespace-name ARE IN RECOVERY PENDING 


Explanation: This message is issued after a successful 
RECOVER TORBA, TOCOPY utility to inform the user of the 
state of all indexes belonging to the recovered table space. All 
indexes are put into the RECOVERY PENDING state to prevent 
the problem of data and index inconsistency. All indexes should 
be recovered before they are used. 


Internal DB2 Information = 7 = 
This message is issued by the following CSECT(s): DSNUGSRX 


eh ates End of Internal DB2 Information seria inoacs iN 


Severity: 4 (warning) 


User Response: A RECOVER of all indexes of the recovered 
table space should be taken. 


DSNU5591_—sccsect-name - INDEX = index-name PART = parti- 


tion number IS IN RECOVERY PENDING state. 


Explanation: The index or the partition of a cluster index-is in 
RECOVERY PENDING state because duplicate index entries 
existed during the BUILD phase of the recover index/index par- 
tition. Duplicate index entries must be resolved before invoking 
RECOVER INDEX again to recover the index and remove the 
index from the RECOVERY PENDING state. 


[ ” ” Internal DB2 Information ~~ ca 
This message is issued by the following CSECT(s): DSNURBXA 


a Nene ee End of Internal DB2 Information siete eee) 


Severity: 4 (warning) 
User Response: One of the following actions should be taken: 


* Resolve duplicate index entries and rerun the RECOVER 
INDEX utility. 


¢ Use the REPAIR SET NORCVRPEND utility or START DATA- 
BASE FORCE to reset the RECOVERY PENDING state. 
However, these two options will not fix the index. 


DSNU5601_ _—csect-name - TABLESPACE = tablespace PART = 
partition number IS IN RECOVERY PENDING 


STATE. 


Explanation: The table space partition of a table space against 
which the utility was running is in RECOVERY PENDING STATE. 
A RECOVER TABLESPACE at the partition level is required. 


DSNU558I — DSNU563! 


f-2o internal DB2 Information Ss 
This message is issued by the following CSECT(s): DSNUGSRX 


Pie oo pe End of Interna! DB2 information es 


Severity: 4 (warning) 

System Action: No action is taken. 

User Response: One of the following actions should be taken: 
¢ Run RECOVER TABLESPACE on the table space partition. 
¢ Run LOAD REPLACE on the table space partition. 


¢ Use REPAIR SET NORCVRPEND utility or START DATA- 
BASE FORCE to reset the RECOVERY PENDING state. 
However, these two options will not fix the table space. 


DSNUS561I csect-name - TABLESPACE = tablespace-name 


PARTITION = part-num IS IN CHECK PENDING 


Explanation: This message is issued to report the check 
pending status of the specified table space partition. 


| Internai DB2 Information ar iy 
This message is issued by the following CSECT(s): DSNUGSRX 


a ae End of Interna! DB2 Information ge Beate 


Severity: 4 (warning) 


User Response: User should run CHECK DATA utility against 
the table space to guarantee usability of the table space. All 
errors reported by CHECK DATA that put the table space in 
CHECK PENDING should be corrected before attempting to use 
the table space again. 


DSNU5621 csect name - TABLESPACE = tablespace IS IN 


RECOVERY PENDING STATE. 


Explanation: The table space against which the utility was 
running is in RECOVERY PENDING state. A RECOVER 
TABLESPACE is required. 


| ~~ Internal DB2 Information ~~ = eri 
This message is issued by the following CSECT(s): DSNUGSRX 


[is Pree tga End of tnternal DB2 Information Oe eerie 


Severity: 4 (warning) 

System Action: No action is taken. 

User Response: One of the following actions should be taken: 
¢ Run RECOVER TABLESPACE on the table space. 
¢ Run LOAD REPLACE on the table space. 


e Use REPAIR SET NORCVRPEND utility or START DATA- 
BASE FORCE to reset the RECOVERY PENDING state. 
However, these two options will not fix the table space. 


DSNU5631 csect name - TABLESPACE = tablespace-name IS 


IN CHECK PENDING 


Explanation: This message is issued to report the check 
pending status of the specified table space. 


DB2 Messages 3-197 


DSNU572!1 — DSNU580I 


| Internal DB2 Information = 
This message is issued by the following CSECT(s): DSNUGSRX 


Ls End of Internal DB2 Information ___ sd 


Severity: 4 (warning) 


User Response: User should run CHECK DATA utility against 
the table space to guarantee usability of the table space. All 
errors reported by CHECK DATA that put the table space in 
CHECK PENDING should be corrected before attempting to use 
the table space again. 


DSNU572i ~=csect-name ALL BACKUP COPIES FOR THIS 
TABLESPACE OR DATA SET HAVE BEEN 


DELETED FROM THE SYSCOPY TABLE 


Explanation: The MODIFY RECOVERY utility has deleted all of 
the SYSCOPY table records and related SYSLGRNG table 
records for the specified table space or partition. The table 
space or partition is no longer recoverable. 


a Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUMDEL 


leet me fore End of Internal DB2 Information ERE, 


Severity: 4 (warning) 
System Action: Processing completes normally. 


System Programmer Response: The table space or partition is 
no longer recoverable once this message has been received. 
One or more full image copies should be taken to establish a 
base for future recovery. 


DSNU5731 csect-name NO BACKUP COPIES FOUND FOR 


THIS TABLESPACE OR DATASET 


Explanation: The MODIFY RECOVERY utility was unable to 
locate any SYSCOPY records older than the specified AGE or 
prior to the specified DATE. No records have been deleted. 


fo ~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUMDEL 
[| End of Internal DB2 Information _____| 


Severity: 4 (warning) 


System Action: Processing completes normally. 


DSNU574I_ _—csect-name - NON-UNIFORM DISTRIBUTION STA- 
TISTICS DELETED BY MODIFY UTILITY. 


COLUMN = column-name 


Explanation: The Non-Uniform distribution statistics for column 
‘column-name' were successfully deleted. This message is 
issued once no matter how many rows have been deleted. No 
Non-Uniform Distribution statistics exist for the column after you 
run this utility. 


3-198 DB2 Messages and Codes 


fea oe Internal DB2 Information el 
This message is issued by the following CSECT(s): DSNUMDLS 


| Sere End of Internal DB2 Information | 


Severity: 0 (informationa!) 


System Action: The MODIFY utility continues its termination 
processing. 


DSNU575I_ _—scsect-name - MODIFY COMPLETED SUCCESS- 


FULLY 


Explanation: This message reports the successful completion 
of the MODIFY utility. The requested cleanup of old 
SYSIBM.SYSCOPY entries has been completed. 


| ; Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUMODA 


Cees te ee End of internal DB2 Information pote eee 


Severity: 8 (error) 


System Action: The MODIFY utility has completed normally. 


DSNU5761 NON-UNIFORM DISTRIBUTION STATISTICS DID 


NOT EXIST FOR COLUMN =column-name 


Explanation: The Non-Uniform distribution statistics for column 
‘column-name' did not exist. 


[ ~~ Internal DB2 Information x | 
This message is issued by the following CSECT(s): DSNUMDLS 


be ees End of Internal DB2 Information be Sel 


Severity: 4 (warning) 


System Action: The MODIFY utility continues its termination 
processing. 


DSNU5801_ _=csect-name REPORT UTILITY COMPLETE, 


ELAPSED TIME = hh/mm/ss 


Explanation: The message is issued at the normal completion 
of the REPORT utility. The time that elapsed since the beginning 
of the REPORT utility to its completion was 'hh' hours, 'mm' 
minutes, and 'ss' seconds. 


TOS internal DB2 Information << 
This message is issued by the following CSECT(s): DSNUPORT 


eee End of Internal DB2 Information wee ted) 


Severity: 0 (informational) 


System Action: This message indicates the normal completion 
of the REPORT utility. Processing continues to the next utility 
statement in the utility job-step, if any. If not, the utility job-step 
is normally terminated, and the resources held become avail- 
able for further processing. The UTILID of the utility job-step 
becomes available for reuse. 


DSNU581I csect-name REPORT RECOVERY TABLESPACE 


dbname.tsname 


Explanation: The message is issued at the beginning of 
reporting the recover information for a table space. 


| Internal DB2 Information =s = = 
This message is issued by the following CSECT(s): DSNUPREC 


ee End of Internal DB2 Information = 


Severity: 0 (informational) 


System Action: Utility processing continues. 


DSNU582I _ csect-name REPORT RECOVERY TABLESPACE 


dbname.tsname SYSCOPY ROWS 


Explanation: Header message for the SYSCOPY section of the 
REPORT RECOVERY output. This section displays the 
SYSCOPY rows for the specified table space or table space par- 
tition as specified in the REPORT RECOVERY input statement. 


| internal DB2 Information = | 
This message is issued by the following CSECT(s): DSNUPPCP 


Ls End of Internal DB2 Information = 


Severity: 0 (informational) 


DSNUS583I_ _csect-name REPORT RECOVERY TABLESPACE 


dbname.tsname SYSLGRNG ROWS 


Explanation: Header message for the SYSLGRNG section of 
the REPORT RECOVERY output. This section displays the 
SYSLGRNG rows for the specified table space as specified in 
REPORT RECOVERY input statement. 


| Internal DB2 Information : = | 
This message is issued by the following CSECT(s): DSNUPPLR 


oa eet End of Internal DB2 Information pee eae 


Severity: 0 (informational) 


System Action: Processing continues normally. 


csect-name REPORT RECOVERY TABLESPACE 
dbname.tsname BSDS VOLUMES 


DSNU584I 


Explanation: Header message for the BSDS VOLUMES section 
of the REPORT RECOVERY output. This section contains BSDS 
volumes for the archive log records associated with the table 
space specified in the REPORT RECOVERY input statement. 


(~~ -2 ee Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUPPBS 


be eee ees End of Internal DB2 Information eee | 


Severity: 0 (informational) 


System Action: Utility processing continues. 


DSNU5811 — DSNU588I 


DSNU5851 csect-name REPORT RECOVERY TABLESPACE 


dbname.tsname CURRENT 


Explanation: The message is issued in response to the 
CURRENT option of REPORT RECOVERY utility. !t indicates that 
only the information since the last recoverable point for the 
specified table space is reported. 


f internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUPREC 


[see cee End of internal DB2 Information perce tS Oa 


Severity: 0 (informational) 


System Action: Normal utility processing continues. 


DSNU5861  csect-name REPORT RECOVERY TABLESPACE 


dbname.tsname SUMMARY: 


Explanation: This is the header message for the SUMMARY 
section of the REPORT RECOVERY utility. All the volumes to be 
used by the RECOVER utility are summarized. 


eae iae Internal DB2 Information Se oo wt 
This message is issued by the following CSECT(s): DSNUPSUM 


boi End of Internal DB2 Information eee ee 


Severity: 0 (informational) 


System Action: This message is part of the output of REPORT 
RECOVERY utility. Utility processing continues. 


DSNU587I _csect-name REPORT TABLESPACE SET WITH 


TABLESPACE dbname.tsname 


Expianation: Header message for the REPORT 
TABLESPACESET output. The output contains all table spaces, 
tables, and dependent tables associated with the table space 
specified in the REPORT TABLESPACESET input statement. 


[ — {nternal DB2 Information ~~ “| 
This message is issued by the following CSECT(s): DSNUPSET 


{End of Internal DB2 Information ____| 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNUS588I csect-name NO DATA TO BE REPORTED 


Explanation: The message is issued when no data can be 
found for a section of the REPORT output. 


[ Internal DB2 Information se | 


This message is issued by the following CSECT(s): 


DSNUPPBS DSNUPPCP DSNUPPLR 
DSNUPSET DSNUPSUM 


ae End of Internal DB2 Information ees aod 
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DSNU589I — DSNU604! 


Severity: 0 (informational) 


System Action: Utility processing continues. 


DSNUS589I csect-name REPORT RECOVERY TABLESPACE 


dbname.tsname COMPLETE 


Explanation: The message is issued at the normal completion 
of reporting the RECOVERY information of the table space in 
REPORT RECOVERY utility. 


[eee anaes Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNUPREC 


rn End of Internal DB2 Information os Ae 


Severity: 0 (informational) 


System Action: This message indicates the normal completion 
of the REPORT RECOVERY utility. Processing continues to the 
next utility statement in the utility job-step, if any. If not, the 
utility job-step is normally terminated, and the resources held 
become available for further processing. The UTILID of the 
utility job-step becomes available for reuse. The output from 
REPORT RECOVERY is now available for RECOVER utility use. 


DSNU590I _csect-name DATABASE RESOURCE NOT AVAIL- 


ABLE - database-name 


Explanation: A database descriptor control block could not be 
accessed. The database may be in a stopped state. 


fC - oo Internal DB2 Information a | 
This message is issued by the following CSECT(s): DSNUGACC 


eras es End of Internal DB2 Information ee eens eel 


Severity: 4 (warning) 


System Action: Utility processing continues to the next 
request. 


User Response: Determine the cause for unavailability. The 
-DISPLAY DATABASE command can be used to determine the 
status. After ensuring the database is available, resubmit the 
job for those objects contained in the database. 


DSNUG600I_ _—sccsect-name INDEX creator.index-name POINTS TO 


A DIFFERENT DATABASE.. 


Explanation: A specified index does not point to a table in the 
database selected. For a RUNSTATS Format 1 invocation, the 
database is the one specified (or defaulted) in the 
TABLESPACE parameter. For a RUNSTATS Format 2 invoca- 
tion, the database is the one which contains the first index in 
the index-name list. 


fe. Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNUSVAL 


fede ees End of Internal DB2 Information Seti ot | 


Severity: 8 (error) 
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System Action: All remaining RUNSTATS invocation parame- 
ters are validated and the executing utility job terminates. 

Work performed by previous utilities in the job-step remains in 
effect. Subsequent utility contro! statements are flushed. No 
record of the utility job-step is retained in the system; therefore, 
it may not be restarted. 


User Response: Ensure that all indexes in the list point to the 
same database and resubmit the RUNSTATS job. 


Problem Determination: Refer to catalog table 
SYSIBM.SYSINDEXES to determine the table upon which the 
index is based. This table must be in the database and table 
space targeted by the RUNSTATS utility. 


DSNU601! csect-name INDEX creator.index-name POINTS TO 


A DIFFERENT TABLESPACE. 


Explanation: A specified index does not point to a table in the 
table space selected. For a RUNSTATS Format 1 invocation, 
the table space is the one specified in the TABLESPACE param- 
eter. For a RUNSTATS Format 2 invocation, the table space is 
the one which contains the table pointed to by the first specified 
index. 


Sea Internal DB2 Information a ed 
This message is issued by the following CSECT(s): DSNUSVAL 


re End of Internal DB2 Information atten 2s! Sort 


Severity: 8 (error) 


System Action: All remaining RUNSTATS invocation parame- 
ters are validated and the executing utility job terminates. 

Work performed by previous utilities in the job-step remains in 
effect. Subsequent utility control statements are flushed. No 
record of the utility job-step is retained in the system; therefore, 
it may not be restarted. 


User Response: Ensure that all indexes in the list point to 
tables in the targeted table space and resubmit the RUNSTATS 
job. 


Problem Determination: Refer to catalog table 
SYSIBM.SYSINDEXES to determine the table upon which the 
index is based. Using the table-name found in 
SYSIBM.SYSINDEXES, refer to catalog table 
SYSIBM.SYSTABLES to determine the containing table space. 


DSNU604I_ _—scsect-name object IS EMPTY 


Explanation: The object currently to be scanned by the 
RUNSTATS utility contains no records. The 'object' may be 
TABLESPACE or INDEXSPACE. 


ae ~ Internal DB2 Information ~_ | 


This message is issued by the following CSECT(s): DSNUSTBL, 
DSNUSIDX 


Pentaho cata! End of internal DB2 Information her ehest eal 


Severity: 0 (informational) 


System Action: The object currently to be scanned is recorded © 
in the catalog as being empty. The statistics for the object are 
updated and RUNSTATS continues to the next object, if there is 
one. 


csect-name ERROR OCCURRED ACCESSING 
TABLESPACE database-name.tablespace-name 


DSNU605I 


Explanation: A previous error makes it impossible for 
RUNSTATS to scan TABLESPACE 'creator.tbspname'. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUSVAL 


[Ss End of Internal DB2 Information ____——_—id 


Severity: 8 (error) 


System Action: The executing utility job-step terminates. Work 
performed by previous utilities in the job-step remains in effect. 
Subsequent utility control statements are flushed. No record of 
the utility job-step is retained in the system; therefore, it may 
not be restarted. 


User Response: Examine prior error messages for error iden- 
tification. If the error can be corrected, resubmit the 

RUNSTATS utility in a new utility job-step. {If the problem cannot 
be corrected, determine the failing environment, and refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: Prior error messages identify this 
error. See the documentation for these error messages in this 
manual for additional problem determination. 


DSNU606!_ csect-name USER NOT AUTHORIZED TO ACCESS 


TABLESPACE database-name.tablespace-name 


Explanation: This user is not authorized to execute the 
RUNSTATS utility against TABLESPACE 'creator.tbspname'. 


[- : Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUSVAL 


reece End of Internal DB2 Information eee dl 


Severity: 8 (error) 


System Action: The executing utility job-step terminates. Work 
performed by previous utilities in the job-step remains in effect. 
Subsequent utility control statements are flushed. No record of 
the utility job-step is retained in the system; therefore, it may 
not be restarted. 


User Response: Contact your system administrator to obtain 
the proper authority, or have another user with the required 
authority execute the utility for you. 


csect-name ERROR OCCURRED ACCESSING 
INDEXSPACE creator.index-name 


DSNU607I 


Explanation: A previous error makes it impossible for 
RUNSTATS to scan INDEXSPACE 'creator.indexspacename'. 


Internal DB2 Information > 
This message is issued by the following CSECT(s): DSNUSVAL 


See eres End of Internal DB2 Information ee 


Severity: 8 (error) 


DSNU605I — DSNU609I 


System Action: The executing utility job-step terminates. Work 
performed by previous utilities in the job-step remains in effect. 
Subsequent utility control statements are flushed. No record of 
the utility job-step is retained in the system; therefore, it may 
not be restarted. 


User Response: Examine prior error messages for error iden- 
tification. If the error can be corrected, resubmit the 
RUNSTATS utility in a new utility job-step. 


Problem Determination: Prior error messages identify this 
error. See the documentation for these error messages in this 
manual for additional problem determination. If the problem 
cannot be corrected, determine the failing environment, and 
refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


csect-name USER NOT AUTHORIZED TO ACCESS 
INDEXSPACE creator.index-name 


DSNU608I 


Explanation: This user is not authorized to execute the 
RUNSTATS utility against INDEXSPACE 
‘creator.indexspacename'. 


| interna! DB2 Information | 
This message is issued by the following CSECT(s): DSNUSVAL 


Pe ett End of internal DB2 Information ee al 


Severity: 8 (error) 


System Action: The executing utility job-step terminates. Work 
performed by previous utilities in the job-step remains in effect. 
Subsequent utility control statements are flushed. No record of 
the utility job-step is retained in the system; therefore, it may 
not be restarted. 


User Response: Contact your system administrator to obtain 
the proper authority, or have another user with the required 
authority execute the utility for you. 


DSNU6091 csect-name TABLE table-name IS IN A DIFFERENT 


TABLESPACE 


Expianation: A table listed in the table name list of the 
RUNSTATS TABLE keyword was not found in the specified table 
space. 


[ ; Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUSVAL 


Vaetgseee End of Internal DB2 Information een et Oh 


Severity: 8 (error) 


System Action: The executing utility job-step terminates. Work 
performed by previous utilities in the job-step remains in effect. 
Subsequent utility control statements are flushed. No record of 
the utility job step is retained by the system; therefore it may 
not be restarted. 


User Response: Ensure that all tables in the list are in the 
specified table space and resubmit the utility. 


Problem Determination: Refer to the catalog table 
SYSIBM.SYSTABLES to determine the table space in which the 
table is located. 
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DSNU6101 — DSNU642I 


‘DSNU6G10I =csect-name catalog-table-name CATALOG 


UPDATE FOR object-name SUCCESSFUL 


Explanation: This message indicates that the updating of the 
statistics columns in the CATALOG TABLE 
'‘catalog-table-name' was successful. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNUSUCO DSNUSUIP DSNUSUIX 
DSNUSUTB DSNUSUTP DSNUSUTS 


nese ere cee End of Internal DB2 Information a 


Severity: 0 (informational) 


System Action: Processing continues with the next catalog 
table. 


DSNU6111 csect-name COLUMN column-name NOT FOUND 


FOR TABLE creator.table-name. 


Explanation: A column name, given as an operand of the 
COLUMN keyword, was not found to be in the specified table. 


| Internal DB2 information 


This message is issued by the following CSECT(s): DSNUSVAL, 
DSNUMDLS 


ee End of Internal DB2 Information ae | 


Severity: 8 (error) 


System Action: Validation of the utility invocation statement is 
completed and the executing utility job-step is terminated. 


User Response: Ensure that the column name given in the 
message is correct for the table specified. 


Problem Determination: Check that the column name specified 
in the utility invocation statement is identical to that found in the 
SYSIBM.SYSCOLUMNS catalog table. Correct any errors and 
reissue the utility job. 


DSNU621I csect-name RUNSTATS COMMIT/ROLLBACK 


FAILED 


Explanation: The RUNSTATS utility has updated the catalog 
with gathered statistics and has tried either to commit those 
changes or to perform rollback processing to remove them fol- 
Jowing an error. The commit or rollback has failed. 


p< ~~ Internal DB2 Information ~ 7 


This message is issued by the following CSECT(s): DSNUSDRB, 
DSNUSTBL, DSNUSIDX 


ee ee End of Internal DB2 Information | 


Severity: 8 (error) 


System Action: RUNSTATS processing is terminated. Subse- 
quent utility control statements in the utility job-step are exe- 
cuted. 


3-202 DB2 Messages and Codes 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: This is an internal error. 


DSNU640I csect-name DATA SET = nnn OF TABLESPACE = 
tttttttt IN DATABASE = dddddddd HAS. BEEN 


MIGRATED BY HSM 


Explanation: The STOSPACE utility has found that a DB2 data 
set has been migrated by the Data Facility Hierarchical Storage 
Manager. The amount of storage space used cannot be deter- 
mined for DATA SET 'nnn' of TABLESPACE 'tittttit' in DATA- 
BASE 'dddddddd'. The space allocation information in the 
catalog will not include the storage used by the migrated data 
set. 


| — Internal DB2 Information ~~~ | 
This message is issued by the following CSECT(s): DSNUTSSA 


| cee End of Internal DB2 Information pgs ns 


Severity: 0 (informational) 


System Action: Processing continues to the next data set in the 
storage group, if any. 


System Programmer Response: If required, the data set may 
be recalled using HSM, and the STOSPACE utility may be run 
again. 


DSNU641I csect-name DATA SET= nnn OF INDEXSPACE = 
iiiiiiii IN DATABASE = dddddddd HAS BEEN 


MIGRATED BY HSM 


Explanation: The STOSPACE utility has found that a DB2 data 
set has been migrated by the Data Facility Hierarchical Storage 
Manager. The amount of storage space used cannot be deter- 


BASE 'dddddddd'. The space allocation information in the 
catalog will not include the storage used by the migrated data 
set. 


T—_ Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUTSSA 
ee eee End of Internal DB2 Information Bae a 


Severity: 0 (informational) 


System Action: Processing continues to the next data set in the 
storage group, if any. 


System Programmer Response: /f required, the data set may 
be recalled using HSM, and the STOSPACE utility may be run 
again. 


DSNU642I_ _—csect-name UNABLE TO ACCESS DBD FOR DATA- 


BASE = dddddddd, TABLESPACE = tttttttt 


Explanation: A database descriptor control block could not be 
accessed by the STOSPACE utility. Information in the DBD is 
required before space allocation data can be obtained from the 
appropriate ICF catalog. Storage space used by table space 
‘tttttttt' in database 'dddddddd' cannot be determined. 


po ~ Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNUTSSA 


ees End of Internal DB2 Information eee oe 


Severity: 4 (warning) 


System Action: Processing continues with the next storage 
group. 


User Response: Determine the cause for unavailability. The 
database may be stopped or the DBD may be marked as 
invalid. The -DISPLAY DATABASE command can be used to 
determine the status. 


System Programmer Response: Determine if the reason for 
the DBD unavailability may require system corrective action. 


Problem Determination: A DSNT5011 message may have been 
sent to the operator console. If so, see the problem determi- 
nation section for message DSNT501I in the “Service Controller 
and Installation Messages (DSNT...)” on page 3-121 section. 


DSNU643I_ _—scsect-name UNABLE TO ACCESS DBD FOR DATA- 


BASE = dddddddd, INDEXSPACE = tttttttt 


Explanation: A database descriptor control block could not be 
accessed by the STOSPACE utility. Information in the DBD is 
required before space allocation data can be obtained from the 
appropriate ICF catalog. Storage space used by index space 
'tttttttt' in database 'dddddddd' cannot be determined. 


| — Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNUTSSA 


re ee End of internal DB2 Information eee rd 


Severity: 4 (warning) 


System Action: Processing continues with the next storage 
group. 


User Response: Determine the cause for unavailability. The 
database may be stopped or the DBD may be marked as 
invalid. The -DISPLAY DATABASE command can be used to 
determine the status. 


System Programmer Response: Determine if the reason for 
the DBD unavailability may require system corrective action. 


Problem Determination: A DSNT501! message may have been 
sent to the operator console. If so, see the problem determi- 
nation section for message DSNT501I in the “Service Controller 
and Installation Messages (DSNT...)” on page 3-121 section. 


DSNU644I csect-name USER user-name NOT AUTHORIZED 


FOR STOSPACE UTILITY 


Explanation: Utility processing for the user indicated on the job 
card failed, because the user is not authorized to execute the 
STOSPACE utility. 


DSNU6431 — DSNU646I 


i 2) Internal DB2 Information es a 
This message is issued by the following CSECT(s): DSNUTSSA 


{ End of Internal DB2 Information Rae a 


Severity: 8 (error) 


System Action: Utility processing is terminated without 
invoking the requested utility or utilities. 


User Response: Contact the systems programmer for assist- 
ance with your security classification. 


System Programmer Response: If the USER specified on the 
job card is incorrect, correct it, and resubmit the job. To run 
the STOSPACE utility, the user must either have SYSADM 
authority or have been granted the STOSPACE privilege. Use 
the SQL GRANT command to give the user the desired 
authority. 


DSNU645I_ _csect-name NO STORAGE GROUPS NAME FOUND 


Explanation: You requested the STOSPACE utility to report on 
all storage groups, but no storage group was found. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUTSSA 


bee End of Internal DB2 Information Se a | 


Severity: 4 (warning) 
This condition does not prevent subsequent processing. 


System Action: This message indicates completion of the 
STOSPACE utility. Processing continues to the next utility state- 
ment in the utility job-step, if any. If not, the utility job-step is 
normally terminated. Resources are released to their prior 
availability state. The UTILID of the utility job-step becomes 
available for reuse. 


User Response: This message indicates that there are no 
storage groups defined. Consult the system programmer to 
determine the reason for this condition. 


System Programmer Response: This message indicates either 
that no storage groups were defined by the installation process 
(or by subsequent SQL procedures) or they have all been 
dropped. If this is an error, the required storage groups must 
be re-created with the CREATE STOGROUP SQL statement. 


DSNU646I csect-name STORAGE GROUP NAME nnnnnnnn 


NOT FOUND 


Explanation: The message is issued by STOSPACE when one 
of the requested storage groups is not found. 


[ Internal DB2 Information == | 
This message is issued by the following CSECT(s): DSNUTSSA 


[ee End of Internal DB2 Information ‘ee 


Severity: 4 (warning) 


System Action: Processing proceeds normally to the next 
storage group if any. 
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DSNU647I — DSNU652I 


User Response: Refer to SYSIBM.SYSTOGROUP for the 
correct spelling of storage groups known to DB2. Submit 
another request with the correct storage group designated. 


DSNU647! csect-name UNAVAILABLE REASON X reason- 
code UNAVAILABLE TYPE X type-code, 
TABLESPACE NAME = table-space-name NOT 


FOUND 


Explanation: The indicated table space was not available for 
Processing by the STOSPACE utility. The reason for its unavail- 
‘ability is given in 'reason code'. The type of unavailability is 
given in 'type code’. 


a ~~~ _ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNUTSSA 


Lo End of Internal DB2 Information _ 


Severity: 4 (warning) 


System Action: Processing continues to the next table space in 
the storage group, if any. 


User Response: Determine the cause for unavailability. When 
the table space becomes available again, resubmit the 
STOSPACE storage-group request in another utility job-step. 


System Programmer Response: Determine if the reason code 
and type:code require system corrective action. 


Problem Determination: The reason the resource is unavail- 
able is identified by a reason code. The reason codes that 
appear in this message are described in “Section 4. DB2 
Codes”. Use Figure 4 in Appendix B, “Problem 
Determination” on page X-5 to find the type of resource identi- 
fied in the message. 


DSNU648I csect-name UNAVAILABLE REASON X reason 
code, UNAVAILABLE TYPE X type-code, INDEX 


NAME =index-name NOT FOUND 


Explanation: The indicated index was not available for proc- 
essing by the STOSPACE utility. The reason for its unavail- 
ability is given in 'reason code'. The type of unavailability is 
given in 'type code’. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUTSSA 


sete End of Internal DB2 Information ee 


Severity: 4 (warning) 


System Action: Processing continues to the next index in the 
storage group, if any. 


User Response: Use the reason code and type code to deter- 
mine why the resource was unavailable. When the index 
becomes available again, resubmit the STOSPACE storage- 
group request in another utility job-step. 


System Programmer Response: Determine if the reason code 
and availability code require system corrective action. 


Problem Determination: The reason the resource is unavail- 
able is identified by a reason code. The reason codes that 
appear in this message are described in “Section 4. DB2 
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Codes” on page 4-1. Use Figure 4 in Appendix B, “Problem 
Determination” on page X-5 to find the type of resource identi- 
fied in the message. 


DSNU650I csect-name control-statement-text 


Explanation: Each control statement is returned to the invoker 
as a part of the normal output. If an error occurred while proc- 
essing the statement, a separate error message follows this 
message. 


[SS Internal DB2 Information : | 


This message is issued by the following CSECT(s): 


DSNUGDFL DSNUGUTC DSNUCBRP 
DSNURWI 


{| sEnd of Internal DB2 Information _____——_| 


Severity: 0 (informational) 


System Action: The processing of the utility request continues 
normally. 


DSNU651I csect-name SET NOCOPYPEND OPERATION SUC- 


CESSFUL 


Explanation: This message reports the successful completion 
of the REPAIR SET TABLESPACE NOCOPYPEND utility opera- 
tion. The COPY PENDING restriction has been removed from 
the specified table space. 


| = = Internal DB2 Information ~~ aati 
This message is issued by the following CSECT(s): DSNUCBRS 


eet ot End of Internal DB2 Information eee ee 


Severity: 0 (informational) 


System Action: The REPAIR SET statement has completed 
normally. 


DSNU6521 


Explanation: This message is issued during REPAIR utility 
processing in response to a VERIFY control statement. It indi- 
cates the verification requested was successful, permitting a 
subsequent REPLACE request to take effect. 


csect-name VERIFY OPERATION SUCCESSFUL 


| ; Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUCBRP 


[End of Internal DB2 Information ____——_| 


Severity: 0 (informational) 


System Action: The requested verification was successful. If 
this is the only verification required for the subsequent 
REPLACE control statement, the REPLACE control statement 
takes effect. If there are other verification control statements, 
they must also complete successfully before the subsequent 
REPLACE control statement takes effect. 


DSNU654I_ _—scsect-name VERIFY OPERATION FAILED, DATA IS 


hex-data 


Explanation: The verify operation requested on the control 
statement failed. The actual data is given as 'hex-data'. 


| Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNUCBRP 


pee ee End of Internal DB2 Information | 


Severity: 4 (warning) 


System Action: Ali REPAIR REPLACE actions subject to the 
current LOCATE scope are ignored. Processing continues at 
the next LOCATE request, if any. 


User Response: Determine why the data (as reported in the 
message) does not match the expectations of VERIFY option. 
Make the appropriate correction, and resubmit the REPAIR 
request in a new utility job-step. 


Problem Determination: The REPAIR DUMP option can help 
you determine the correct verification data. Refer to Chapter 3 
of Command and Utility Reference for REPAIR processing con- 
straints. 


DSNUG655i _csect-name DELETE OPERATION SUCCESSFUL 


Explanation: This message is issued during the REPAIR utility 
in response to a DELETE control statement. 


| ~—~—~——~_ Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNUCDEL 


ees End of internal DB2 Information eae se: 


Severity: 0 (informational) 


System Action: The data record specified on the previous 
LOCATE statement and ail of its related INDEX entries have 
been deleted from the system. Processing continues. 


DSNU6561 csect-name REPLACE OPERATION SUCCESSFUL, 


DATA WAS hex-data 


Explanation: This message is issued by the REPAIR utility in 
response to a REPLACE control statement request. The 
message indicates that replacement of the data has occurred 
and that the replaced data had the indicated hexadecimal value 
('hex-data'). 


[ ~~ Internal DB2 Information a: | 
This message is issued by the following CSECT(s): DSNUCBRP 


{ End of Internai DB2 Information wht hell 


Severity: 0 (informational) 


System Action: The REPAIR utility has located the indicated 
record, performed all the requested verifications, and has 
replaced the data in the record at the indicated offset with the 
new data as defined by the REPLACE control statement. The 
change has been committed. 


DSNU654I — DSNU660I 


Although the change has been committed, it has not been 
fogged. If a changed record is recovered before an image copy 
is made, the REPAIR must be reapplied. 


However, to make the repair persist across subsequent 
RECOVER operations, an image copy should be taken subse- 
quent to the completion of the REPAIR utility. 


DSNU6571_ _csect-name REPLACE RESET OPERATION SUC- 


CESSFUL 


Explanation: This message is issued by the REPAIR utility in 
response to a REPLACE RESET control statement request. The: 
message indicates that the broken page indicator has been 
reset. 


[ Internal DB2 Information er 
This message is issued by the following CSECT(s): DSNUCBRP 


a oer End of Internal DB2 information eee 


Severity: 0 (informational) 


System Action: The REPAIR utility has reset the broken page 
indicator for the specified page. Although the reset indicator 
has been committed, it has not been logged. If the page is 
recovered before an image copy is made, the REPAIR RESET 
must be reapplied. 


However, to make the repair persist across subsequent 
RECOVER operations, an image copy should be taken subse- 
quent to the completion of the REPAIR utility. 


DSNU6581_ _csect-name MULTIPLE RECORDS FOUND WITH 


SPECIFIED KEY 


Explanation: The specified key is not unique. Several 
DSNU660I messages, giving possible RID values for this KEY, 
foliow this message. 


| Internal DB2 Information 7 | 
This message is issued by the following CSECT(s): DSNUCBRP 


aS ees End of Internal DB2 Information ei eed 


Severity: 8 (error) 
System Action: Processing continues normally. 


User Response: Change the LOCATE statement to locate the 
desired RID, and resubmit the request in a new utility job-step. 


DSNU660I_ _—sccsect-name POSSIBLE RID rid 


Explanation: '‘rid' is one of several records that map to the 
specified KEY. 


= Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): DSNUCBRP 


| eae End of Internal DB2 Information eens 


Severity: 8 (error) 


System Action: Other records also mapping to the specified 
KEY are identified by other DSNU660! messages. This message 
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DSNU661I — DSNUG666I 


is preceded by message DSNU658!. Processing continues 
normally. 


User Response: Change the LOCATE statement to locate the 

desired RID, and resubmit the request in a new utility job-step. 
Refer to Section 5 of Diagnosis Guide and Reference for a dis- 
cussion of the REPAIR LOCATE KEY option constraints. 


DSNU661I_ csect-name RECORD NOT FOUND IN PAGE, 


MAXID = hex-data 


Explanation: A RID was either specified or obtained from the 
clustering index via the specified KEY. The PAGE indicated in 
the RID did not contain the RECORD indicated in the RID. 


| Internal DB2 information ~~~ ESE 
This message is issued by the following CSECT(s): DSNUCBRP 


| End of Internal DB2 Information sid 


Severity: 8 (error) 


System Action: Processing proceeds to the next LOCATE state- 
ment, if there is one. 


User Response: Either change the LOCATE statement to locate 
a valid RID or KEY, or use LOCATE-PAGE and resubmit the 
REPAIR statements in a new utility job-step. Refer to Section 5 
of Diagnosis Guide and Reference for a discussion of REPAIR 
option constraints. 


DSNU662I_ _csect-name NO RECORD FOUND WITH SPECIFIED 


KEY 


Explanation: A KEY was specified on the LOCATE statement, 
but no entry exists in the clustering index for that KEY. 


[ — Internal DB2 Information es i 
This message is issued by the following CSECT(s): DSNUCBRP 


a End of internal DB2 information oh esas, 


Severity: 8 (error) 


System Action: Processing begins at the next LOCATE state- 
ment, if there is one. 


User Response: Correct the LOCATE statement, and resubmit 
the REPAIR statements in a new utility job-step. 


DSNU663! 


Explanation: The page identified a record identifier (RID) or 
KEY does not exist in the specified table space. 


csect-name PAGE hex-page-number NOT FOUND 


fo internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNUCBRP 
ae ee End of Internal DB2 Information wae eel 
Severity: 0 (informationa!) when issued by DUMP PAGES(n). 8 


(error) when issued by LOCATE PAGE(n). 


System Action: _ Processing begins at the next LOCATE state- 
ment, if there is one. 


User Response: Correct the LOCATE statement, and resubmit 
the REPAIR statements in a new utility job step. 
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DSNU664I_ _—csect-name INVALID OFFSET OR LENGTH FOR 


XXXXX 


Explanation:. ‘xxxxx' is 'RECORD' or 'PAGE'. The specified 
or default values for OFFSET and LENGTH combine to extend 
beyond the specified record or page. 


| ; Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUCBRP 


LT End of Internal DB2 Information er afe te t 


Severity: 4 (warning) 


System Action: Processing continues at the next LOCATE 
statement, if there is one. 


User Response: Correct the OFFSET and/or LENGTH specifica- 
tion, and resubmit the REPAIR statements in a new utility job 
step. Refer to Section 5 of Diagnosis Guide and Reference for a 
discussion of the REPAIR LOCATE constraints. 


DSNU665I csect-name NO RECORD ASSOCIATED WITH 


SPECIFIED RID 


Explanation: A record identifier (RID) was specified on the 
LOCATE statement, but that RID is not associated with any 
record in the specified table space. If DELETE processing 
returns this message, the RID may exist but be invalid for 
DELETE. 


= T. Internal DB2 Information ~ Po ee 


This message is issued by the following CSECT(s): DSNUCBRL, 
DSNUCDEL 


| Seereare eres End of Internal DB2 Information RTT 


Severity: 8 (error) 


System Action: Processing begins at the next LOCATE state- 
ment, if there is one. Subsequent utilities in the same job step 
will not be executed. 


User Response: Correct the LOCATE statement, and resubmit 
the REPAIR statements in a new utility job step. 


Problem Determination: REPAIR DELETE will issue this 
message for RIDs which are internal and do not directly repre- 
sent user data. The DUMP keyword may be used to view the 
RID, if it exists. These internal records may only be repaired 
using the REPLACE keyword. 


DSNUG666I _csect-name NO INDEX EXISTS 


Explanation: The KEY for this table space is not a full clus- 
tering key. The statement is invalid. 


an ~ Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNUCBRP 


ee ee End of Internal DB2 Information ae etn! 


Severity: 8 (error) 


_ System Action: Processing continues at the next LOCATE 


statement, if there is one. 


User Response: Correct the LOCATE statement to use the 
clustering index, or change LOCATE by PAGE or RID. Refer to 
Section 5 of Diagnosis Guide and Reference for a discussion of 
REPAIR LOCATE constraints. 


DSNU668i  csect-name UNABLE TO CONVERT KEY TO format 


Explanation: '‘format' specifies the data type to which the KEY 
specification must be converted. The conversion has failed. 


| : Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUCBRP 


{ End of interna! DB2 information sd 


Severity: 8 (error) 


System Action: Processing begins at the next LOCATE state- 
ment, if there is one. 


User Response: Correct the LOCATE statement to specify a 
KEY either of the indicated data type or of a compatible data- 
type. Then resubmit the REPAIR statements in a new utility job- 
step. Refer to Chapter 3 of Command and Utility Reference for 
a discussion of conversion constraints. 


DSNU669I_ _csect-name INDEX NOT FOUND FOR SPECIFIED 


TABLESPACE 


Explanation: An index was specified on the LOCATE KEY 
statement via the INDEX keyword, but no index by that name 
was found related to the specified TABLESPACE. 


(ae Internal DB2 Information = 4) 
This message is issued by the following CSECT(s): DSNUCBRK 


ae End of Internal DB2 Information ee | 


Severity: 8 (error) 


System Action: Processing begins at the next LOCATE state- 
ment, if there is one. 


User Response: Correct the LOCATE statement and resubmit 
the REPAIR statements in a new utility job step. 


Problem Determination: Valid index names can be found in the 
SYSIBM.SYSINDEXES catalog table. 


DSNU6701 


Explanation: The indicated page located by the REPAIR utility 
has been marked broken by the data manager. The 'page id' 
is given in hexadecimal. This page is not accessible until the 
broken page indicator is reset by the REPAIR REPLACE RESET 
option. 


csect-name PAGE X page-id IS A BROKEN PAGE 


——— Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNUCBRP 


Ph faeain toe End of internal DB2 Information oes Peace 


Severity: 4 (warning) 


DSNU668I — DSNU679I 


System Action: The message reports that the page in which 
the REPAIR utility is requested to REPLACE some data is 
broken. 


User Response: Determine the cause of the broken page with 
the assistance of the system programmer. When it is repaired, 
use the REPAIR RESET option. 


System Programmer Response: Determine the cause of the 
broken page. It could be an internal error and require support 
center assistance. The REPAIR DUMP option can be used to 
determine the contents of the page for failure analysis. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


DSNU6721_ = csect-name INDEX USED HAS MULTIPLE-FIELD 


KEY 


Explanation: A REPAIR LOCATE KEY operation was attempted 
against a table space using an index that has a multiple-field 
key. LOCATE KEY does not support multiple-field keys. 


| es ~ Internal DB2 Information ~~~ ark | 
This message is issued by the following CSECT(s): DSNUCBRP 


a eee End of Internal DB2 Information id 


Severity: 8 (error) 


System Action: Processing begins at the next LOCATE scope, 
if any. 


User Response: Change the LOCATE statement to specify 
PAGE and RID, and resubmit the REPAIR statements in a new 
utility job-step. 


DSNU678I _csect-name VERIFY, REPLACE, DUMP, OR 


DELETE BEFORE LOCATE 


Explanation: The REPAIR utility was requested to VERIFY, 
REPLACE, or DUMP or DELETE a page or record and that page 
of record could not be located. 


[ ——:s«sdARternal DB2 Information ~~ “an 
This message is issued by the following CSECT(s): DSNUCBRP 


ane ae End of Internal DB2 Information eee 


Severity: 8 (error) 


System Action: Processing begins at the next LOCATE state- 
ment, if there is one. Subsequent utilities in the same job step 
will not be executed. 


User Response: Correct the REPAIR control statements, and 
resubmit the request in a new utility job step. Refer to Section 5 
of Diagnosis Guide and Reference for REPAIR option con- 
straints. 


DSNU6791_ _csect-name MULTIPLE 'DELETE'S PER 


‘LOCATE' NOT ALLOWED 


Explanation: The REPAIR utility was requested to DELETE the 
same record more than once. Only one DELETE is allowed per 
LOCATE RID or LOCATE KEY. 
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DSNU680!I — DSNU702I 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUCDEL 


eee End of Internal DB2 Information ete ee 


Severity: 8 (error) 


System Action: Processing begins at the next LOCATE scope, 
if any. Subsequent utilities in the same job-step will not be exe- 
cuted. 


User Response: Remove all but one DELETE control statement 
from each LOCATE scope which is intended to delete a record. 
Refer to Section 5 of Diagnosis Guide and Reference for 
REPAIR option constraints. 


DSNU6801_ _=—scsect-name PAGE hex-page-number 


Explanation: This message is issued as an identifier at the top 
of each page dumped by the REPAIR DUMP PAGES facility. 
"hex-page-number' identifies the page which is about to be 
dumped. 


aid Internal DB2 Information te ee AY 
This message is issued by the following CSECT(s): DSNUCBRR 


[LT End of Internal DB2 Information Ae ete 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU6811_ —csect-name SET NOCHECKPEND OPERATION 


SUCCESSFUL 


Explanation: This message reports the successful completion 
of the REPAIR SET TABLESPACE NOCHECKPEND utility opera- 
tion. The CHECK PENDING restriction has been removed from 
the specified table space. 


| Internal DB2 Information Se ae Eo oy 
This message is issued by the following CSECT(s): DSNUCBRS 


| Peeeeee End of internal DB2 Information ee 


Severity: 0O(informational) 


System Action: The REPAIR SET statement has completed 
normally. 


DSNU682I_ _csect-name SET NORCVRPEND OPERATION SUC- 


CESSFUL 


Explanation: This message reports the successful completion 
of the REPAIR SET NORCVRPEND utility operation. The 
RECOVERY PENDING restriction has been removed from the 
specified table space, from the specified index, or from all 
indexes of the specified table space. 
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| ~— Internal DB2 Information ~~~ | 
This message is issued by the following CSECT(s): DSNUCBRS 


ace oes End of internal DB2 Information a 


Severity: 0 (informational) 


System Action: The REPAIR SET statement has completed 
normally. 


DSNU701I_ _—scsect-name nnnn INDEX ENTRIES UNLOADED 


FROM iili 


Explanation: The CHECK Utility UNLOAD phase unloaded 
‘nnnn' records from the index named ' iiii'. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKGET 


he et End of Internal DB2 Information sd 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU702I_ _—scsect-name INVALID INDEX SPECIFICATION. 


INDEX = iiii 


Explanation: All tables referenced by the INDEXES being 
CHECKed or RECOVERed must be in the same table space. 
Index ‘iiii' is not over a table in the table space specified with 
the TABLESPACE keyword. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKINT 


Diss aise oe End of internal DB2 Information es 


Severity: 8 (error) 
System Action: Utility processing is discontinued. 


User Response: Correct the index name and/or the 
TABLESPACE parameters such that a single table space is 
involved, and rerun the utility job. 


Problem Determination: To CHECK or RECOVER ALL INDEXES 
in a table space, use the TABLESPACE keyword, but do not use 
the list option. This is one way to correct this error. If you want 
to correct the list of indexes specified in the index name list, the 
following procedure will locate the table space name related to 
the index 'iiii'. 


The index name 'iiii' reported in the message is of the form 
‘creator.name'. Obtain the TBCREATOR and TBNAME 
columns from the DB2 catalog table SYSIBM.SYSINDEXES 
where columns CREATOR and NAME have the values reported 
in the message. Obtain the DBNAME and TSNAME columns. 
from the DB2 catalog table SYSIBM.SYSTABLES, where 
columns CREATOR and NAME have the values obtained from 
TBCREATOR and TBNAME of SYSIBM.SYSINDEXES. 


The values for DBNAME and TSNAME must be the same for all 
indexes specified in the index name list and must be the same 
as the table space name specified on the TABLESPACE 
keyword (if provided). 


csect-name INVALID INDEX SPECIFICATION. 
INDEX = iii 


DSNU703! 


Explanation: All tables referenced by the indexes being 
CHECKed or RECOVERed must be in the same table space. 
Index 'iiii' is not over a table in the same table space as the 
prior indexes listed in the index name list. 


[ internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNUKINT 


ee as End of Internal DB2 Information a 


Severity: 8 (error) 
System Action: Utility processing is discontinued. 


User Response: Correct the index name and/or the 
TABLESPACE parameters such that a single table space is 
involved, and rerun the utility job. 


Problem Determination: To CHECK or RECOVER ALL INDEXES 
in a table space, use the TABLESPACE keyword, but do not use 
the list option. This is one way to correct this error. If you want 
to correct the list of indexes specified in the index name list, the 
following procedure will locate the table space name related to 
the index 'iiii'. 


The index name 'iiii' reported in the message is of the form 
‘creator.name'. Obtain the TBCREATOR and TBNAME 
columns from the DB2 catalog table SYSIBM.SYSINDEXES, 
where columns CREATOR and NAME have the values reported 
in the message. Obtain the DBNAME and TSNAME coijumns 
from the DB2 catalog table SYSIBM.SYSTABLES, where 
columns CREATOR and NAME have the values obtained from 
TBCREATOR and TBNAME of SYSIBM.SYSINDEXES. 


The values for DBNAME and TSNAME must be the same for all 
indexes specified in the index name list and must be the same 
as the table space name specified on the TABLESPACE 
keyword if provided. 


DSNU70SI  csect-name UNLOAD PHASE COMPLETE, 


ELAPSED TIME = ttt 


Explanation: The unload phase of the CHECK or RECOVER 
INDEX utility is complete. 


| : — Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUCRIX, 
DSNUKOO01 


ena een End of Internal DB2 Information eet eet 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU7071 _csect-name INDEX ENTRY POINTS TO WRONG 


TABLE. OBID=o0000, RID=rrrr, INDEX = 


Explanation: The CHECK utility CHECKIDX phase found that 
index ‘iiii' contains an entry for key 'kkkk' that points to record 
at RID 'rrrr', but the record belongs to the table with OBID 
*o000'. 


| 
| 


DSNU703! — DSNU710I 


| Internal DB2 Information : | 
This message is issued by the following CSECT(s): DSNUKICK 


ee End of internal DB2 information et 


Severity: 4 (warning) 
System Action: CHECK utility processing continues. 
User Response: Run the RECOVER INDEX utility for index 


DSNU7081 csect-name INDEX IS NOT UNIQUE. INDEX =iiii, 


KEY =kkkk 


Explanation: The CHECK utility CHECKIDX phase found that 
unique index 'iiii' contains a nonunique key, 'kkkk'. 


Internal DB2 Information = | 
This message is issued by the following CSECT(s): DSNUKGET 


[i aetna End of Interna! DB2 Information ee ete 


Severity: 4 (warning) 
System Action: CHECK utility processing continues. 


User Response: Drop the unique index, and delete the dupli- 
cate rows. Re-create the index. 


DSNU7091_ _=csect-name NO INDEX ENTRY FOR ROW. RID- 


=rrer, INDEX =iiii, KEY = kkkk 


Explanation: The CHECK utility CHECKIDX phase found that 
index ‘iiii' is missing an entry for the row at RID 'rrrr' with key 
'kkkk'. 


eee Internal DB2 Information a as 
This message is issued by the following CSECT(s): DSNUKICK 


[oo eae eeee End of Internal DB2 Information ae 


Severity: 4 (warning) 
System Action: CHECK utility processing continues. 
User Response: Run the RECOVER INDEX utility for index 


DSNU7101 csect-name INDEX ENTRY CONTAINS INVALID 


ZERO REPRESENTATION. RID=rerr, INDEX =iiii, 
KEY = kkkk 


Explanation: The CHECK utility CHECKIDX phase found that 
index ‘iiii' has an entry that contains a negative zero. The 
index entry is for the row at RID 'rrrr' with key 'kkkk'. 


| Internal DB2 Information — | 
This message is issued by the following CSECT(s): DSNUKICK 


beeeketeet ens End of Internal DB2 Information A Se 


Severity: 4 (warning) 


System Action: CHECK utility processing continues. 
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DSNU7111 — DSNU720I 


User Response: Run the RECOVER INDEX utility for index 
‘iii’. 


DSNU7111_ csect-name NO ROW FOR INDEX ENTRY. 


RID = rrrr, INDEX =iilii, KEY = kkkk 


Explanation: The CHECK utility CHECKIDX phase found that 
the index 'iiii' contains an entry that has no row. The index 
entry contained RID 'rrrr' and key 'kkkk', but RID 'rrrr' is not 
a valid record. 


| as Internal DB2 Information ae = | 
This message is issued by the following CSECT(s): DSNUKICK 


aera ene End of Internal DB2 Information Be 


Severity: 4 (warning) 
System Action: CHECK utility processing continues. 
User Response: Run the RECOVER INDEX utility for index 


DSNU712! csect-name INDEX OUT OF SEQUENCE. 


INDEX =iili, KEY = kkkk 


Explanation:, The CHECK utility CHECKIDX phase found that 
index 'iiii' is not in correct sequence. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKGET 


ett aoe End of Internal DB2 Information ot At a 


Severity: 4 (warning) 
System Action: CHECK utility processing continues. 
User Response: Run the RECOVER INDEX utility for index 


‘iiti' 


DSNU713I csect-name KEYS MISMATCH. RiID=rrrr, 


INDEX = lili 


Explanation: The CHECK utility CHECKIDX phase found that 
index '‘iiii' contains an entry for the row at rid 'rrrr' that is 
inconsistent. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUKICK 


[Ss End of internal DB2 Information ______| 


Severity: 4 (warning) 
System Action: CHECK utility processing continues. 


User Response: Run the RECOVER INDEX utility for index 
iii". 
DSNU7151 


csect-name MULTIPLE INDEX ENTRIES FOR ROW. 
RID =rrrr, INDEX =illi, KEY = kkkk 


Explanation: The CHECK utility CHECKIDX phase found that 
index 'iiii' has multiple index entries for the row at RID 'rrrr' 
with key 'kkkk'. 
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| 7 Internal DB2 Information ~ —T-e. os 
This message is issued by the following CSECT(s): DSNUKICK 


| End of internal DB2 information = 


Severity: 4 (warning) 
System Action: CHECK utility processing continues. 
User Response: Run the RECOVER INDEX utility for index 


DSNU718I_ _csect-name NO INDEXES FOUND FOR 


TABLESPACE tttt 


Explanation: The CHECK or RECOVER INDEX utility has been 
invoked with the TABLESPACE keyword specifying a table 
space containing tables that have no indexes. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKINT 


[snd of Internal DB2 Information _______| 


Severity: 4 (warning) 


System Action: This message indicates completion of the 
RECOVER INDEX or CHECK INDEX utility. Processing continues 
to the next utility statement in the job-step, if any. If there are 
no utility statements following, the job-step is terminated 
normally and the UTILID of the job-step becomes available for 
reuse. 


User Response: if the table space specification is in error, 
correct it and resubmit the utility. If the table space specifica- 
tion is correct, and the table space contains no indexed tables, 
this is a normal indication and no response is necessary. 


This is an information message. 


DSNU7191 csect-name nnnn ENTRIES CHECKED FOR INDEX 


Explanation: The CHECK utility has completed checking index 
‘iiii' and has processed 'nnnn' index entries. This message 
will be issued once for each index checked. 


Internal DB2 Information ; | 
This message is issued by the following CSECT(s): DSNUKINT 


Doce etae cute End of Internal DB2 Information thie a tl 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU7201_ _csect-name CHECKIDX PHASE COMPLETE, 


ELAPSED TIME = titt 
Explanation: The CHECK utility CHECKIDX phase is complete. 


| Internal DB2 Information —— | 
This message is issued by the following CSECT(s): DSNUKOO1 


Dl End of Internal DB2 Information ee ee 


Severity: 0 (informational) 


System Action: Processing continues. 


DSNU7251 _=csect-name DUPLICATE TABLESPACE NAMES 


EXIST IN THE TABLESPACE LIST 


Explanation: This message is issued by the CHECK DATA 
utility when a duplicate table space is found in the table space 
list. 


| Internal DB2 Information aa) 
This message is issued by the following CSECT(s): DSNUKINP 


es End of Internal DB2 Information ee eee 


DSNU726I  csect-name TABLESPACE tsp HAS NO CHECK 


PENDING FOR SCOPE 


Explanation: This message is issued when 'CHECK DATA 
TABLESPACE tsp SCOPE PENDING' is specified and the 
CHECK DATA utility finds the table space in CHECK PENDING 
state, but the scope indicates nothing to check. The CHECK 
DATA utility proceeds by checking all dependent rows in table 
space 'tsp'. 


| Internal DB2 Information ~~ = 
This message is issued by the following CSECT(s): DSNUKINP 


a End of Internal DB2 information ree 


Severity: 4 (warning) 


System Action: Processing continues. 


DSNU7271  csect-name TABLESPACE tsp IS NOT CHECK 


PENDING 


Explanation: This message is issued when ‘CHECK DATA 
TABLESPACE tsp SCOPE PENDING’ is specified and the 
CHECK DATA utility finds that the table space is not ina CHECK 
PENDING state. The CHECK DATA utility will skip table space 
‘tsp' and will continue with any other table space specified. 
The catalog fields that reflect the extent of a CHECK PENDING 
state are updated to ensure that they indicate that no check is 
required. 


[se ~~~ Internal DB2 Information ie aaa aie 
This message is issued by the following CSECT(s): DSNUKINP 


bee aes End of Internal DB2 Information foe ay 


Severity: 4 (warning) 


‘System Action: Processing continues. 


DSNU7251 — DSNU7301I 


DSNU728I _csect-name INVALID EXCEPTION TABLE table2 


FOR tabie1 


Explanation: This message is issued when the CHECK DATA 
utility finds an exception table is invalid. The exception table 
named 'table2' which was specified for rows from table, 
'table1', is invalid. Either 'table2' was missing columns of 
‘table1' or 'table2' was missing an identifier column. The 
CHECK DATA utility will terminate processing after all excep- 
tion tables have been examined. 


fo _ ~— Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKINE 


a End of Internal DB2 Information | 


Severity: 8 (error) 


System Action: The CHECK DATA utility will terminate proc- 
essing after all the exception tables have been examined. 


User Response: Refer to Section 4 (Volume 2) of Adminis- 
tration Guide for a definition of the CREATE TABLE command 
with the LIKE operand to correct the invalid exception table. 


DSNU728I1_ _—csect-name MISSING EXCEPTION TABLES FOR 


table. 


Explanation: This message is issued when the CHECK DATA 
utility finds a dependent table without an exception table. The 
dependent table 'table1' is not listed with the IN keyword in the 
FOR EXCEPTION clause. The CHECK DATA utility wil! terminate 
processing after all dependent tables have been examined. 


eS Internal DB2 Information os 
This message is issued by the following CSECT(s): DSNUKINE 


————— End of Internal DB2 Information ee 


Severity: 8 (error) 


System Action: The CHECK DATA utility will terminate proc- 
essing after all the dependent tables have been examined. 


User Response: Define the missing exception table with the 
CREATE TABLE command with the LIKE operand. Correct the 
CHECK DATA job to include the exception table and resubmit 
the CHECK DATA utility in a new utility job step. 


DSNU7301 csect-name CHECKING TABLE tab 


Explanation: This message is issued when the CHECK DATA 
utility begins to process a table. The name of table being 
checked is ‘tab’. 


Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNUKDST 


ieee aes End of Internal DB2 information ot oe 


Severity: 0 (informational) 


System Action: Processing continues. 
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DSNU7311 — DSNU751I 


DSNU731I csect-name EXCEPTION LIMIT EXCEEDED 


Explanation: The EXCEPTION limit specified on the CHECK 
utility statement has been exceeded. 


ee Internal DB2 Information] 
This message is issued by the following CSECT(s): DSNUKDCK 


rn End of Internal DB2 Information ewes 


Severity: 8 (error) 
System Action: The CHECK utility terminates processing. 


User Response: If required, increase the exception limit and 
resubmit the job. 


DSNU7321 NO DEPENDENT TABLES TO BE CHECKED FOR 


TABLESPACE tsp 


Explanation: The CHECK DATA utility determined that none of 
the tables in the table space 'tsp' is a dependent table and, 
therefore, no referential relationship is checked. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNUKINP 


Wk na corey End of Internal DB2 Information See 


Severity: 4 (warning) 


System Action: Utility processing continues. 


DSNU7331 csect-name ROW (RID =rrrrrr) HAS NO PARENT 


FOR rel 


Explanation: This message is issued when the CHECK DATA 
utility finds a row in a dependent table without a parent. The 
row with RID, 'rrrrrr', has no parent for the relationship named 
‘rel'. This message is always proceeded by a DSNU730I 
message that identifies the table in error. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKERK 


eStats End of Internal DB2 Information Sone eins 8 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Refer to Section 3 (Volume 1) of Adminis- 
tration Guide for a discussion of CHECK PENDING operation. 


Problem Determination: Refer to Section 3 (Volume 1) of 
Administration Guide for a discussion of the CHECK PENDING 
operation and for failure analysis and recovery procedures. 


DSNU739!_ _—csect-name CHECK TABLE tab COMPLETE, 


elapsed time =t1 


Explanation: This message is issued when the CHECK DATA 
utility finishes processing a table. The elapsed clock time that 
the check of table 'tab' consumed is 't1'. 
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ee Internal DB2 Information => 
This message is issued by the following CSECT(s): DSNUKDAT 


Pate th tee End of Internal DB2 Information eee 


Severity: 0 (informational) 


DSNU741I_ _—scsect-name nn ROWS DELETED FROM TABLE tab 


Explanation: This message is issued during delete processing 
for the CHECK DATA utility when the DELETE YES option is 
specified. The number of rows deleted from TABLE 'tab' is the 
number of rows that contain referential integrity violations plus 
their descendent rows. The number of rows deleted from 
TABLE 'tab' will be equal to the number of rows inserted into 
the corresponding exception table. 


internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUKRDY 


[a eee End of Internal DB2 Information eaten 


Severity: 4 (warning) 


System Action: Processing continues. 


DSNU7491__—s csect-name CHECK DATA COMPLETE, ELAPSED 


TIME = t1 


Explanation: This message is issued when the CHECK DATA 
utility is complete. The elapsed clock time that the CHECK 
DATA utility consumed is 'tt'. 


as Internal DB2 Information oe so ear eh 
This message is issued by the following CSECT(s): DSNUKO01 


[eet iece End of Internal DB2 information eee 


Severity: 0 (informational) 


System Action: Processing ends. 


DSNU750I_ _——csect-name CATALOG LOAD STARTED 


Explanation: This message marks the start of the RESTCAT 
load utility. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUECMO, 
DSNUECMU, DSNUEXLO 


ae eee End of Internal DB2 Information _ 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU751I_ _csect-name CATALOG LOAD OF TABLE - table- 


Explanation: This message is issued the first time data is 
loaded into the designated table. 


[ ~~ Internal DB2 Information =F ss, 4 
This message is issued by the following CSECT(s): DSNUECML 


a End of Internal DB2 Information Seat 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU7521 csect-name CATALOG LOAD COMPLETE 


Explanation: This message marks the successful completion of 
the RESTCAT toad utility. 


| —_ Internal DB2 information ee 
This message is issued by the following CSECT(s): DSNUECML 


Po set et End of Internal DB2 Information eee se nd) 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU7531_ _csect-name CATALOG UNLOAD STARTED 


Explanation: This message marks the start of the 
RESTCAT/DUMPCAT unload utility. 


[ Interna! DB2 Information ~ PNT AN eM 
This message is issued by the following CSECT(s): DSNUECMO 


ee End of Internal DB2 Information peosee eee 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU7541_ = csect-name CATALOG UNLOAD OF TABLE - tabie- 


Explanation: This message is issued the first time data is 
unloaded from the designated table. 


| Internal DB2 information i | 
This message is issued by the following CSECT(s): DSNUEXUN 


eee End of internal DB2 Information oo eee 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU7551 


Explanation: This message marks the successful completion of 
the RESTCAT/DUMPCAT unload utility. 


csect-name CATALOG UNLOAD COMPLETE 


DSNU7521 — DSNU7591I 


| : Internal DB2 Information - | 
This message is issued by the following CSECT(s): DSNUECMO 


Serene End of Internal DB2 Information pets | 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU756! csect-name CATALOG TABLE IS EMPTY - table- 


Explanation: This message is issued when the named table is 
empty. 


7 ~ Internal DB2 Information ~~ =| 
This message is issued by the following CSECT(s): DSNUECMU 


ee, End of Internal DB2 Information fet es 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU757I _csect-name CATALOG MIGRATION DROPPED 


VIEW - view-name 


Explanation: This message is issued when a view cannot be 
migrated. 


| — ~~~ Internal DB2 Information == we 
This message is issued by the following CSECT(s): DSNUEXLO 


bate eres End of internal DB2 Information na 


Severity: 4 (warning) 


System Action: Utility processing continues normally. 


DSNU758i_ _csect-name CATALOG MIGRATION DROPPED 


VIEW FAILED FOR - view-name 


Explanation: This message is issued when an attempt to drop 
a view failed. The formatted SQLCA is printed following this 
message. 


ee ae " Internal DB2 Information ~_ st 
This message is issued by the following CSECT(s): DSNUEXLO 


| End of Internal DB2 Information 


Severity: 4 (warning) 


System Action: Utility processing continues normally. 


DSNU7591_ _ csect-name INCORRECT UNLOAD DATA SET HAS 


BEEN DETECTED 


Explanation: This message indicates an inconsistency 
between the release level of the unloaded catalog and the DB2 
release that is running the RESTCAT utility. 
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DSNU760I — DSNU765i 


a —_ Internal DB2 Information “~~ | 
This message is issued by the following CSECT(s): DSNUECML 


eee ees End of Internal DB2 Information poss See ew 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: Review the JCL for the job to ensure that the 
correct unload data set is specified. Verify that the correct level 
of DB2 is up. 


DSNU7601_ _—scsect-name SPECIFIED USER NOT AUTHORIZED 


AS THE FIRST INSTALLATION-DEFINED SYSADM 


Explanation: The RESTCAT/DUMPCAT utility can be run only 
under the authority of the first installation-defined SYSADM. 


_ ~~ Internal DB2 information ~ | 
This message is issued by the following CSECT(s): DSNUECMI 


ee End of Internal DB2 Information ae 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: Rerun the utility with the proper authori- 
zation. 


DSNU761I _—scsect-name CREATE VIEW FAILED FOR - view- 


Explanation: The RESTCAT utility’s attempt to create a view 
failed. The create view statement follows this message. The 
formatted SQLCA is also printed in the SYSOUT file. 


Se Internal DB2 information —_-— a 
This message is issued by the following CSECT(s): DSNUEXLO 


[ea End of Internal DB2 Information ee I 


Severity: 4 (warning) 
System Action: Utility processing continues normally. 


User Response: Examine the output to verify that the create 
view failure was correct. 


DSNU762I1 _csect-name DUPLICATE RECORD DETECTED FOR 


TABLENAME - table-name SEQNO OF THE INPUT 
RECORD IS - seqno FOLLOWING IS UP TO 120 
BYTES OF RECORD BEING INSERTED 


Explanation: An object created in the target catalog has the 
same name as an object being migrated from the source 
catalog. 


| ae Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUECML 


Gee ote End of Internal DB2 Information ee a 


Severity: 8 (error) 
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System Action: Utility abends. 


User Response: User data should not be in the target catalog 
before running the RESTCAT utility. Free or drop the object 
from the target catalog and re-run the RESTCAT utility. 


DSNU763I csect-name AN ATTEMPT TO RUN THE RESTCAT 
UTILITY MORE THAN ONCE WITHOUT 


REINSTALLING THE CATALOG 


Explanation: This message indicates the catalog has been pre- 
viously migrated an attempt to migrate again was detected by 
the RESTCAT utility. 


[eee Internal DB2 Information Fo n= 
This message is issued by the following CSECT(s): DSNUEXLO 


_————- End of Internal DB2 Information aa 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: Reinstall the catalog and follow installation 
procedures for niigrating the catalog. 


DSNU7641_ _csect-name FOLLOWING IS UP TO 120 BYTES OF 
RECORD FOR TABLE table-name, SEQNO seqno 


BEING PROCESSED AT THE TIME OF ERROR 


Explanation: An abend occurred during the execution of the 
RESTCAT utility, during the processing of the table, 
'table-name', with a sequence number of 'seqno'. The cause 
of the abend is one of the following: 


¢ The record sequence number was invalid. 

e An unexpected return code was received from DSNUEXLO. 

¢ The table name was not found in the load table 
(DSNUELTB). 

¢ The parent record could not be positioned. 

¢ The position OBID was zero (DSNUELTB has incorrect 
value). 

¢ The record action code is incorrect. 


Following this message, up to the first 120 bytes of the record in 
question is displayed. 


Ce ee Internal DB2 information we et 
This message is issued by the following CSECT(s): DSNUECML 


or aes End of Internal DB2 Information eer) 


Severity: 8 (error) 
System Action: Utility abends. 


User Response: Verify that the record in the unloaded data set 
is correct. 


DSNU765i csect-name THE DB2 SYSTEM iS NOT AT THE 
REQUIRED SERVICE LEVEL. CATALOG NOT 


UPDATED. 


Explanation: The DB2 Catalog is not at the proper service level 
to migrate the catalog. Please refer to the Program Directory 
for the required service level for the release of DB2 you are 
migrating to. 


| ~~ Internal DB2 Information gre eG 
This message is issued by the following CSECT(s): DSNUEXUN 


[dete End of Internal DB2 Information eae ee | 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: Fall back to the previous release and install 
the required level of service. 


DSNU766i csect-name THE CATALOG HAS ALREADY BEEN 


MIGRATED. NO ACTION WILL BE TAKEN. 


Explanation: The catalog has already been successfully 
migrated. There is no reason to rerun the catalog migration 
job, therefore no action will be taken to update the DB2 Catalog. 


a ~~ Internal DB2 Information ea 
This message is issued by the following CSECT(s): DSNUEXUN 


[ete ere End of Internal DB2 Information ioe 


Severity: 8 (error) 


System Action: Utility processing terminates. 


DSNU7701_ _—csect-name - DBD type STARTED FOR DATABASE 


database 


Explanation: This message marks the start of the REPAIR DBD 
type utility. In the message, ‘type’ can be DIAGNOSE, 
REBUILD, or TEST. The database name specified in the 
REPAIR statement is ‘database’. 


a Internal DB2 information ane 
This message is issued by the following CSECT(s): DSNUECMO 


[ee teste Sota tees End of internal DB2 Information a 


Severity: 0 (informationa!) 


System Action: Utility processing continues normally. 


DSNU7711_ _csect-name - DBD type COMPLETE FOR DATA- 


BASE database 


Explanation: This message marks the completion of the 
REPAIR DBD type utility. In the message, 'type' can be DIAG- 
NOSE, REBUILD, or TEST. The database name specified in the 
REPAIR statement is 'database'. 


re Internal DB2 Information aay | 
This message is issued by the following CSECT(s): DSNUECMO 


idee ees End of Interna! DB2 Information gee 


Severity: 0 (informational) 


System Action: Utility processing continues normally. 


DSNU7661 — DSNU775I 


DSNU772i_ _—scsect-name - THE object-type qualifier.object- 


name IS UNAVAILABLE IN THIS RELEASE 


Explanation: This message indicates that the specified object 
has a dependency on a release from which fall back has 
occurred, and cannot be operated upon in the current release. 


~~ —~_ Internal DB2 Information — = =e 
This message is issued by the following CSECT(s): DSNUEXDB 


eee ee End of internal DB2 information ot oe ko 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: Check the IBMREQD column of the catalog 
table associated with the specified object type. If the value in 
the catalog table is the release dependency mark for a release 
of DB2 from which fall back has occurred, the utility is not oper- 
ational for the current release of the targeted database. 


DSNU7731 . csect-name - database IS A SYSTEM DATABASE 


AND CANNOT BE PROCESSED 


Explanation: The database indicated by the utility control 
statement is a DB2 Catalog or DB2 Directory database. Neither 
of these databases is eligible for processing. 


[ Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUECMO, 
DSNUEXDB 


bee ees End of Internal DB2 Information sees 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: Ensure that the utility control statement speci- 
fies the correct database. 


DSNU774I csect-name - SPECIFIED DATABASE database 


NOT FOUND 


Explanation: The database indicated by the utility control 
statement was not found in catalog table 
SYSIBM.SYSDATABASE. 


SF Internal DB2 Information Se NAR a || 
This message is issued by the following CSECT(s): DSNUEXDB 


ee End of internal DB2 Information geet eal 


Severity: 8 (error) 
System Action: Utility processing terminates. 


User Response: Ensure that the database indicated by the 
utility control statement exists in SYSIBM.SYSDATABASE. 


DSNU775i csect-name - DROP OF DATABASE dbname 


FAILED WITH SQLCODE = sqicode 


Explanation: An error was encountered while using the 
REPAIR DBD DROP utility to drop DATABASE 'dbname'. The 
SQL code of the error is indicated by 'sqicode'. 
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DSNU780I — DSNU864! 


ia aad Internal DB2 Information pg 
This message is issued by the following CSECT(s): DSNUECMO 


ee ee, End of Internal DB2 Information ee ate 


Severity: 8 (error) 
System Action: DATABASE 'dbname' is not dropped. 


User Response: For a description of the SQL code that was 
issued, refer to “Section 2. SQL Return Codes” on page 2-1. 


DSNU780I_ _—csect-name DSNUTILB LEVEL Release 3 INVALID 


WITH SUBSYSTEM LEVEL Version 2 


Explanation: JCL has been submitted which executes level 
‘Release 3' of DSNUTILB against a level 'Version 2' DB2 sub- 
system. The levels must match. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGBAC 


Ds eee ‘End of Internal DB2 Information ee 


Severity: 8 (error) 
System Action: The utility terminates with a return code of 8. 


User Response: Determine the DB2 subsystem against which 
you wish to execute. Determine which STEPLIB data set con- 
tains the corresponding DSNUTILB load module. Correct the 
JCL to specify the correct data set on the STEPLIB DD card and 
the correct DB2 subsystem on the EXEC card and resubmit the 
job. 


DSNU781I csect-name RESTART OF LEVEL Release 3 


UTILITY AT LEVEL Version 2 INVALID 


Explanation: JCL has been submitted which attempts to 
RESTART a stopped utility. The utility began processing at 
level 'Release 3' and cannot be restarted at level 'Version 2'. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUGUCA, 
DSNUGUTC 


bet tl! End of Internal DB2 Information ote, ee 


Severity: 8 (error) 
System Action: The utility terminates with a return code of 8. 


User Response: Either restart the utility at the same level it 
was originated or terminate the utility with the TERM command 
and resubmit it at the new level. Refer to Chapter 2 of 
Command and Utility Reference for special TERM command 
considerations. 


DSNU782I_ _—scsect-name UNABLE TO RECOVER DUE TO 


ACTIVITY AT ANOTHER SYSTEM LEVEL 


Explanation: The RECOVER utility is unable to recover the 
specified table space. Activity at another system level has left 
all image copies for this table space inconsistent with the DB2 
LOG. 
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Internal DB2 Information a ae | 
This message is issued by the following CSECT(s): DSNUGBAC 


eee End of Internal DB2 Information eee) 


Severity: 8 (error) 
System Action: The utility terminates with a return code of 8. 


User Response: The table space, in its entirety can not be 
recovered. Individual data sets may be recoverable using the 
DSNUM() keyword. 


DSNU860!_ =csect-name DIAGNOSE UTILITY COMPLETE 


Explanation: This message is issued in response to the normal 
completion of the DIAGNOSE utility. 


| =~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNUDIAG, 
DSNUGUTC 


[eee oe End of Internal DB2 Information aera Ee | 


Severity: 0 (informational) 


System Action: This message indicates the normal completion 
of the DIAGNOSE utility. Processing continues to the next utility 
statement in the utility job-step. 


DSNU863! 


Explanation: This message is the heading message for DIAG- 
NOSE DISPLAY OBD output. 


csect-name DISPLAY OBD dbname.tsname 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUDISP 


eee = End of Internal DB2 Information eee | 


Severity: 0 (informational) 


System Action: This message indicates the start of the output 
for the DIAGNOSE DISPLAY OBD function. 


DSNUS64I_ _—sccsect-name DISPLAY OBD, DBID=nn OBID=nn 


OBD TYPE =type 


Explanation: This message is the heading message for the 
OBD being displayed. 


fe ee Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNUDISO 


ee eeeren eta End of Internal DB2 Information pees eee 


Severity: 0 (informational) 


System Action: This message identifies the OBD being dis- 
played. 


DSNU865I csect-name DISPLAY OBD dbname.tsname COM- 


PLETE 


Explanation: This message is issued in response to normal 
completion of DISPLAY OBD processing. 


et a Internal DB2 Information z “| 
This message is issued by the following CSECT(s): DSNUDISP 


Lo End of Internal DB2 Information _ 


Severity: 0 (informational) 


System Action: This message indicates the end of DISPLAY 
OBD processing. 


DSNU866I _csect-name DISPLAY SYSUTIL JOB INFORMATION 


Explanation: This message is the header message for the 
SYSUTIL JOB INFORMATION section of the DIAGNOSE DISPLAY 
SYSUTIL output. This section displays the job information area 
of the SYSUTIL record and contains information which identifies 
the utility the SYSUTIL record is referencing. 


ee ae Interna! DB2 Information ee. ea 
This message is issued by the following CSECT(s): DSNUDISS 


ese tee® ee: End of Internal DB2 Information eee 


Severity: 0 (informational) 


System Action: This message identifies the SYSUTIL JOB 
INFORMATION section of the DIAGNOSE DISPLAY SYSUTIL 
output. 





DSNU8671I csect-name DISPLAY SYSUTIL 


CHECKPOINT/RESTART INFORMATION 


Explanation: This message is the header message for the 
SYSUTIL UTILITY CHECKPOINT/RESTART INFORMATION 
section of the DIAGNOSE DISPLAY SYSUTIL output. This 
section displays the utility checkpoint/restart area of the 
SYSUTIL record and contains information pertaining to utility 
processing needed for the restart of the utility. 


—— — Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNUDISS 


[End of Internal DB2 Information ___———d 


Severity: 0 (informational) 


System Action: This message identifies the SYSUTIL UTILITY 
CHECKPOINT/RESTART INFORMATION section of the DIAG- 
NOSE DISPLAY SYSUTIL output. 


DSNU868! _csect-name DISPLAY SYSUTIL UTILITY 


DEPENDENT AREA 


Explanation: This message is the header message for the 
SYSUTIL UTILITY DEPENDENT INFORMATION section of the 
DIAGNOSE DISPLAY SYSUTIL output. This section displays the 
utility dependent area of the SYSUTIL record and contains infor- 
mation particular to the utility which the SYSUTIL record is ref- 
erencing. 


DSNU865I — DSNU90OI 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUDISS 


po End of Internal DB2 Information eee, 


Severity: 0 (informational) 


System Action: This message identifies the SYSUTIL UTILITY 
DEPENDENT INFORMATION section of the DIAGNOSE DISPLAY 
SYSUTIL output. 


DSNUS69I_ _csect-name DISPLAY SYSUTIL COMPLETE 


Explanation: This message is issued in response to normal 
completion of DISPLAY SYSUTIL processing. 


internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUDISS 


eee End of Internal DB2 information ee eee, 


Severity: 0 (informational) 


System Action: This message indicates the end of DISPLAY 
SYSUTIL processing. 


DSNU870I _csect-name NO SYSUTIL RECORD FOUND 


Explanation: This message is issued if no SYSUTIL records are 
found when DISPLAY SYSUTIL is specified. 


| : ~ Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNUDISS 


Page End of Internal DB2 information eee, 


Severity: 0 (informational) 


System Action: This message indicates the end of DISPLAY 
SYSUTIL processing. 


DSNUS00I csect-name - DBD X'xxxx' COMPARISON 


STARTING 


Explanation: This message marks the start of a DBD compar- 
ison for the REPAIR DBD TEST or REPAIR DBD DIAGNOSE 
utility. The DBID of the DBD being compared against the DB2 
Catalog is 'xxxx'. 


| Internal DB2 Information tr" : | 
This message is issued by the following CSECT(s): DSNUEDDR 


Pets ete End of Internal DB2 Information esas feces 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 
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DSNUS901I — DSNUS907I 


DSNU9S01!  csect-name - OBD X'xxxx' obd-type HAS THE 


FOLLOWING DIFFERENCES 


Explanation: This message marks the start of an OBD compar- 
ison for the REPAIR DBD TEST or REPAIR DBD DIAGNOSE 
utility. This message is displayed when a difference in the 
OBDs has been detected. The OBID of the OBD being com- 
pared against the DB2 Catalog is 'xxxx'. The type of OBD 
being displayed is 'obd-type'. 


as ~~ Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNUEDDR DSNUEDF! DSNUEDFS 
DSNUEDPS DSNUEDRT 


Ret eee tae End of Internal DB2 Information ere 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUS902i_ _—s csect-name - EXISTING OBD AT OFFSET 


X'xxxxxxxx' IN EXISTING DBD 


Explanation: Following this message is a hexadecimal dump of 
the OBD as it exists in the DSNDB01.DBD01 page set. In the 
message, 'xxxxxxxx' is the hexadecimal offset from the begin- 
ning of the existing DBD as it appears later in the REPAIR DBD 
DIAGNOSE output. 


[— ee Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNUEDDR DSNUEDFI DSNUEDFS 
DSNUEDPS DSNUEDRT 


ere ee End of Interna! DB2 information tea ce 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUS031_~—s csecct-name - REBUILT OBD AT OFFSET 


X'xxxxxxxx' IN REBUILT DBD 


Explanation: Following this message is a hexadecimal dump of 
the OBD that was rebuilt from the DB2 Catalog. In the message, 
*Xxxxxxxx! is the hexadecimal offset from the beginning of the 
rebuilt DBD as it appears later in the REPAIR DBD DIAGNOSE 

_ output. 


i... Internal DB2 Information ~~ ~ | 


This message is issued by the following CSECT(s): 


DSNUEDDR DSNUEDFI DSNUEDFS 
DSNUEDPS DSNUEDRT 


Lo End of Internal DB2 Information _____——_| 


Severity: 0 (informational) 
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System Action: DBD checking continues normally. 


DSNU904I csect-name - EXISTING VALUE X'xx..xx' 


Explanation: This message shows a hexadecimal string which 
is the value of a field in the OBD as it exists on the 
DSNDB01.DBD01 page set. The hexadecimal string is 'xx..xx'. 


[Roa internal DB2 Information a. 


This message is issued by the following CSECT(s): 


DSNUEDDR DSNUEDF! DSNUEDFS 
DSNUEDPS DSNUEDRT 


Pee a End of Internal DB2 information ees 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUSO5I csect-name - REBUILT VALUE X'xx..xx' 


Explanation: This message shows a hexadecimal string which 
is the value of a field in the OBD which was rebuilt from the DB2 
Catalog. The hexadecimal string is 'xx..xx'. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNUEDDR DSNUEDFI DSNUEDFS 
DSNUEDPS DSNUEDRT 


bee End of internal DB2 information soe tet oh 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUSO6I csect-name - EXISTING VALUE 'cc..cc' 


Explanation: This message shows a character string which is 
the value of a field in the OBD as it exists on the 
DSNDB01.DBD01 page set. The character string is 'cc..cc'. 


Internal DB2 Information paeerera ] 


This message is issued by the following CSECT(s): 


DSNUEDDR DSNUEDFI DSNUEDFS 
DSNUEDPS DSNUEDRT 


eas End of Internal DB2 Information ee eee 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUS$071I csect-name - REBUILT VALUE 'cc..cc' 


Explanation: This message shows a character string which is 
the value of a field in the OBD which was rebuilt from the DB2 
Catalog. The character string is ‘cc..cc’. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNUEDDR DSNUEDFI DSNUEDFS 
DSNUEDPS DSNUEDRT 


Lo End of Internal DB2 Information eee Eee 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUS908I_ _—scsect-name - EXISTING OBD IS obd-type 


Explanation: This message shows the OBD type of the OBD 
which exists on the DSNDB01.DBD01 page set. 


| Internal DB2 Information = ioe 
This message is issued by the following CSECT({s): DSNUEDDR 


Uh pope eee End of Internal DB2 Information pete 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUS091 


Explanation: This message shows the OBD type of the OBD 
which was rebuilt from the DB2 Catalog. 


‘an ~~ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUEDDR 


{ End of Internal DB2 Information _ 


Severity: 0 (informational) 


csect-name - REBUILT OBD IS obd-type 


System Action: DBD checking continues normally. 


DSNUS101 = csect-name - EXISTING DBD 


Explanation: Following this message is a hexadecimal! dump of 
the DBD which exists on the DSNDB01.DBD01 page set. 


Internal DB2 Information Se Ss 
This message is issued by the following CSECT(s): DSNUEDDR 


| End of internal DB2 Information | 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNU9111 


Explanation: Following this message is a hexadecimal dump of 
the DBD which was rebuilt from the DB2 Catalog. 


csect-name - REBUILT DBD 


DSNU908!1 — DSNU914I 


| ~ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUEDDR 


Mee ee End of Internal DB2 Information a | 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNU9121  csect-name - phase-compietion-message -- nn 


ERRORS WERE FOUND 


Explanation: This message marks the end of a processing 
phase in the DBD comparison for a REPAIR DBD TEST or 
REPAIR DBD DIAGNOSE utility. In the message, 'nn' indicates 
the number of errors detected while processing. Informational 
and warning messages are not added into the error count. 


[ — «sd ternal DB2 information ~ ——————S~S | 


This message is issued by the following CSECT(s): DSNUEDDR, 
DSNUEDLO, DSNUEDSP 


De ee End of Internal DB2 Information Soe | 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNU9131 ~=—csect-name - OBD X'xxxx' COMPARISON COM- 


PLETE -- nn ERRORS WERE FOUND 


Explanation: This message marks the end of an OBD compar- 
ison for the REPAIR DBD TEST or REPAIR DBD DIAGNOSE 
utility. This message is displayed only when a difference has 
been detected. If there is no difference, this message will not 
be displayed. The OBID of the OBD being compared against 
the DB2 Catalog is 'xxxx'. The number of errors in this OBD is 
'nn'. informational and warning messages are not added into 
the error count. 


| Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNUEDDR 


(ee eee End of Internal DB2 Information Seen a 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNUS141 _csect-name - DBD X'xxxx' COMPARISON COM- 


PLETE -- nn ERRORS WERE FOUND 


Explanation: This message marks the end of a DBD compar- 
ison for the REPAIR DBD TEST or REPAIR DBD DIAGNOSE 
utility. The DBID of the DBD being compared against the DB2 
Catalog is 'xxxx'. The total number of errors found in this DBD 
is 'nn'. 
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DSNU915I — DSNU9Z211 


| internal DB2 Information oo a: | 
This message is issued by the following CSECT(s): DSNUEDDR 


———— End of Internal DB2 Information ef | 


Severity: 0 (informational) 


System Action: DBD checking completed. 


DSNU915! cesect-name - OBD X'obid' E-X'xxxxxxxx' 


R-X'yyyyyyyy' obd-description 


Explanation: This message is used when listing the OBDs in 
the REPAIR DBD DIAGNOSE utility. The OBID of the OBD being 
listed is 'obid'. The offset to the OBD within the EXISTING DBD 
which is displayed later in the output is 'xxxxxxxx'. The offset 
to the OBD within the REBUILT DBD which is displayed later in 
the output is 'yyyyyyyy'. A short description of the state of the 
OBD is ‘obd-description’. 


| Internal DB2 Information Oe 
This message is issued by the following CSECT(s): DSNUEDLO 


Ue Sees End of Internal DB2 Information ets 2 el 


Severity: 0 (informational) 


System Action: DBD checking completed. 


DSNU916 csect-name - OBDS DIFFER AT OFFSET 
X'xxxxxxxx' field-name - INFORMATION NOT IN 


DB2 CATALOG 


Explanation: This message indicates the value of a field in the 
OBD differs from the DBD which exists on the DSNDB01.DBD01 
page set and the DBD rebuilt from from the DB2 Catalog. This 
is information which is not kept in the DB2 Catalog. This is an 
acceptable difference and does not indicate that the OBD is 
damaged. The hexadecimal offset from the beginning of the 
OBD is 'xxxxxxxx'. The name of the field is 'field-name'. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUEDDR, 
DSNUEDFI, DSNUEDFS, DSNUEDPS, DSNUEDRT 


eee et End of Internal DB2 Information stare 2.8 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


csect-name - DBDS DIFFER AT OFFSET 
X'Xxxxxxxx' field-name - INFORMATION NOT IN 
DB2 CATALOG 


DSNU917I 


Explanation: This message indicates that the value of a field in 
the DBD differs from the DBD which exists on the 
DSNDBO01.DBD01 page set and the DBD rebuilt from the DB2 
Catalog. This is information which is not kept in the DB2 
Catalog. This is an acceptable difference and does not indicate 
that the DBD is damaged. The hexadecimal offset from the 
beginning of the DBD is 'xxxxxxxx'. The name of the field is 
'field-name’. 
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ee Internal DB2 Information eT 
This message is issued by the following CSECT(s): DSNUEDDR 


ee: End of Internal DB2 Information eee reas 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNU9191_ _csect-name - DBD X'xxxx' OBD X'yyyy' - details 


Explanation: This message gives detailed information about 
the specified OBD. The DBID of the DBD is 'xxxx'. The OBID of 
the OBD is 'yyyy'. A description of the error is ‘details’. 


[ See ge ae Internal DB2 Information 


This message is issued by the following CSECT(s): DSNUEDCO, 
DSNUEDSP 


{| End of Internal DB2 Information eae ee 


Severity: 0 (informational) 


System Action: DBD checking continues normally. 


DSNU920!_ _—scsect-name - OBDS DIFFER AT OFFSET 


X'xxxxxxxx' field-name 


Explanation: This message indicates that the value of a field in 
the OBD differs from the DBD which exists on the 
DSNDB01.DBD01 page set and the DBD rebuilt from from the 
DB2 Catalog. The DB2 Catalog and DBD/OBD are inconsistent. 
The hexadecimal offset from the beginning of the OBD is 
"Xxxxxxxx'. The name of the field is 'field-name'. 


~ Internal DB2 Information : | 


This message is issued by the following CSECT(s): DSNUEDDR, 
DSNUEDFI, DSNUEDFS, DSNUEDPS, DSNUEDRT 


ee End of Internal DB2 Information es 


Severity: 4 (warning) 


System Action: DBD checking continues normally. 


DSNU921I_ _—csect-name ~- OBD X'xxxx' MISSING IN EXISTING 


DBD 


Explanation: This message indicates that an OBD which was 
rebuilt from the DB2 Catalog does not exist in the the DBD 
which exists on the DSNDB01.DBD01 page set. The DB2 
Catalog and DBD/OBD are inconsistent. The OBID of the 
missing OBD is 'xxxx'. 


(<i aad internal DB2 Information + 4 
This message is issued by the following CSECT(s): DSNUEDDR 


Cee ae oe, End of Internal DB2 Information ee 


Severity: 4 (warning) 


System Action: DBD checking continues normally. 


DSNU922I _—csect-name - OBD X'xxxx' MISSING IN REBUILT 


DBD 


Explanation: This message indicates that an OBD in the DBD 
which exists on the DSNDB01.DBD01 page set does not exist in 
the DBD which was rebuilt from the DB2 Catalog. The DB2 
Catalog and DBD/OBD are inconsistent. The OBID of the 
missing OBD is 'xxxx'. 


[2 - .¢ Internal DB2 Information a et eee 
This message is issued by the following CSECT(s): DSNUEDDR 


bee ee ee End of internal DB2 Information oe ee | 


Severity: 4 (warning) 


System Action: DBD checking continues normally. 


DSNU923!1 csect-name—OBDTYPE FOR OBD X'xxxx' DOES 


NOT MATCH —NO FURTHER CHECKING DONE 
FOR THIS OBD 


Explanation: The object descriptor (OBD) that exists on the 
DSNDBO01.DBD01 page set is different from the type of OBD that 
was rebuilt from the DB2 catalog. No further processing can be 
done because the fields of one OBD type are different from the 
fields of another. The DB2 catalog and database descriptor 
(DBD)/OBD are inconsistent. The object identifier (OBID) of the 
OBD that is inconsistent is 'xxxx'. 


p= an Internal DB2 Information ee ee as al 
This message is issued by the following CSECT(s): DSNUEDDR 


ee End of internal DB2 Information ee 


Severity: 4 (warning) 


System Action: Checking for OBD X'xxxx' stops. Checking of 
the DBD continues normally. 


DSNU924!1 csect-name—DBDS DIFFER AT OFFSET 


X'xxxxxxxx' field-name 


Explanation: The value of a field in the database descriptor 

(DBD) differs from the value of the corresponding field in the 
DBD that exists on the DSNDB01.DBD01 page set and differs 

from the value of the corresponding field in the DBD that was 
rebuilt from the DB2 catalog. 


XXXXXXXX 
fietd-name 


iP Internal DB2 Information ~~ Y 
This message is issued by the following CSECT(s): DSNUEDDR 


es End of Internal DB2 Information | 


Severity: 0 (informational) 


The hex offset from the beginning of the DBD. 
The name of the field. 


System Action: Checking of the DBD continues normally. 


DSNU925!I 


DSNU922!1 — DSNU927I 


csect-name—OBDDFILE AT OFFSET X' xxxxxxxx' 
IN EXISTING DBD HAS OBID X'nnnn' WHICH IS 
NOT A FILE OBD 


Explanation: The field that points to the first FILE OBD 
(OBDDFILE) in the database descriptor (DBD) that exists on the 
DSNDBO01.DBD01 page set does not point to a FILE OBD. The 
DB2 catalog and DBD/OBD (object descriptor) are inconsistent. 


XXXXXXxX The hex offset from the beginning of the existing 
DBD. 

The object identifier (OBID) of the OBD which should 
be a FILE OBD. 


[ek internal DB2 Information ~ a 
This message is issued by the following CSECT(s): DSNUEDDR 


{End of internal DB2 Information sd 


Severity: 4 (warning) 


annn 


System Action: Checking of the DBD continues normaily. 


DSNU926]  csect-name—OBDDFILE AT OFFSET X'xxxxxxxx' 


IN REBUILT DBD HAS OBID X'nnnn' WHICH IS 
NOT A FILE OBD 


Explanation: The field that points to the first FILE OBD 
(OBDDFILE) in the database descriptor (DBD) that was rebuilt 
from the DB2 catalog does not point to a FILE OBD. The DB2 
catalog and DBD/OBD (object descriptor) are inconsistent. 


XXXXXXxXX The hex offset from the beginning of the rebuilt DBD. 
nnnan The object identifier (OBID) of the OBD that should 
be a FILE OBD. 


a aa internal DB2 Information a) 
This message is issued by the following CSECT(s): DSNUEDDR 


Pe eet et End of internal DB2 Information eee eee eee 


Severity: 4 (warning) 


System Action: Checking of the DBD continues normally. 


DSNU927I csect-name—OBD X'xxxx' IS A HOLE IN EXISTING 


DBD 


Explanation: The object descriptor (OBD) that exists on the 
DSNDB01.DBD01 page set has been logically deleted, 
OBDHOLE = '1'B. The DB2 catalog and database descriptor 
(DBD)/OBD are inconsistent. The object identifier (OBID) of the 
OBD that is a hole is 'xxxx'. 


[tt™~CSOS internal DB2 Information “so oe a 
This message is issued by the following CSECT(s): DSNUEDDR 


=a End of Internal DB2 Information eee 


Severity: 4 (warning) 


System Action: Checking of the DBD continues normally. 
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DSNU928I — DSNU971I 


DSNUS28I_ _csect-name—OBD X'xxxx' IS A HOLE IN REBUILT 


DBD 


Explanation: The object descriptor (OBD) that was rebuilt from 
the DB2 catalog has been logically deleted, OBDHOLE = '1'B. 

The DB2 catalog and database descriptor (DBD)/OBD are incon- 
sistent. The object identifier (OBID) of the OBD that is a hole is 

"xxxx'!. 


(< . ere Internal DB2 information eS a 
This message is issued by the following CSECT(s): DSNUEDDR 


eer End of Internal DB2 Information eee 


Severity: 4 (warning) 


System Action: Checking of the DBD continues normally. 


DSNUS29} csect-name—OBD FIELD field-name HAS VALUE 
OUT OF RANGE AT OFFSET X 'xxxxxxxx' IN OBD 


X'nnnn' 


Explanation: The object descriptor (OBD) field ‘field-name' 
has an unexpected value. The DB2 catalog and database 
descriptor (DBD)/OBD are inconsistent. 


field-name The name of the field in the OBD. 
XXXXXXXX The hex offset from the beginning of the OBD. 
nnnn The object identifier (OBID) of the OBD. 


[~ rae internal DB2 Information ~ 


This message is issued by the following CSECT(s): 
DSNUEDDR DSNUEDFI DSNUEDFS DSNUEDPS 
DSNUEDRT 


L End of Internal DB2 Information teens el 


Severity: 4 (warning) 


System Action: Checking of the DBD continues normally. 


DSNUS930I1 csect-name—INDEX index-name (OBD X 'xxxx') 


MUST BE RECOVERED 


Explanation: The index 'index-name' must be either recov- 
ered or dropped and recreated to ensure that the index is con- 
sistent with the description in the INDEX FANSET OBD. The 
object descriptor (OBD) is not damaged. However, if the index 
is not either recovered or dropped and recreated, incorrect 
output can be produced when the index is used as an access 
path. 


index-name The name of the index found in 
SYSIBM.SYSINDEXES. 
XXXX The object identifier (OBID) of the OBD. 


| " Internal DB2 information : } 
This message is issued by the following CSECT(s): DSNUEDFS 


re End of internal DB2 Information Pees cael 


Severity: 8 (error) 
System Action: Checking of the DBD continues normally. 
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DSNU938I csect-name—OBD X'xxxx' HAD DIFFERENCES 


WHICH WERE NOT IN A NAMED FIELD 


Explanation: There is a difference between the object 
descriptor (OBD) in the database descriptor (DBD) that exists 
on the DSNDB01.DBD01 page set and the DBD that was rebuilt 
from the DB2 catalog. This difference does not exist in a named 
field. Therefore, the detailed search by field name fails to find 
the difference. The DB2 catalog and DBD/OBD are inconsistent. 
The object identifier (OBID) of the OBD in error is 'xxxx'. 


[ — Internal DB2 Information ~~ aia | 
This message is issued by the following CSECT(s): DSNUEDDR 


bets = et End of Internal DB2 Information Bees it | 


Severity: 4 (warning) 
System Action: Checking of the DBD continues normally. 


DSNU939!  csect-name—DBD HEADER HAD DIFFERENCES 


WHICH WERE NOT IN A NAMED FIELD 


Explanation: There is a difference between the DBD header in 
the DBD that exists on the DSNDB0O1.DBD01 page set and the 
DBD that was rebuilt from the DB2 catalog. This difference 
does not exist in a named field. Therefore, the detailed search 
by field name fails to find the difference. The DB2 catalog and 
database descriptor (DBD)/object descriptor (OBD) are incon- 
sistent. 


[<> ~~ Internal DB2 Information ~— —Y 
This message is issued by the following CSECT(s): DSNUEDDR 


| End of Internal DB2 Information 


Severity: 4 (warning) 


System Action: Checking of the DBD continues normally. 


DSNU9711 csect-name TABLESPACE dbname.tsname IS 
CHECK PENDING CORRELATION-ID id1 


CONNECTION-ID id2 LUW-ID id3 


Explanation: This message is sent to the console when 
TABLESPACE 'tsname' is set CHECK PENDING. The 
CORRELATION-ID 'id1' is the correlation identifier of the 
thread requesting CHECK PENDING. The CONNECTION-ID 
‘id2' is the correlation identifier of the thread. The LUW-ID 
‘id3' is the logical-unit-of-work identifier of the thread. If the 
LUW-ID is an '*', the thread has no LUW-ID. If not an '*', the 
value is a logical-unit-of-work-id that is assigned to the thread 
followed by an '=' sign and a token value which may be used 
in place of logical-unit-of-work-id in any DB2 command that 
accepts logica!-unit-of-work-id as input. 


| ~~ Internal DB2 Information —~— ne 
This message is issued by the following CSECT(s): DSNUGCKP 


[eee ea End of Internal DB2 Information dee 3 


Severity: 4 (warning) 


System Action: Processing continues. 


User Response: Refer to Section 4 (Volume 2) of Adminis- 
tration Guide for a discussion of the CHECK PENDING opera- 
tion. 


Problem Determination: Refer to Section 4 (Volume 2) of 
Administration Guide for a discussion of the CHECK PENDING 
operation and for failure analysis and recovery procedures. 


csect-name CATALOG UPDATING FAILURE WHILE 
SETTING CHECK PENDING CORRELATION-ID id1 
CONNECTION-ID id2 LUW-ID id3 


Explanation: When CHECK PENDING state is set on or off, the 
updating of the catalog tables (SYSTABLESPACE, SYSTABLES, 
and SYSTABLEPART) fails. The CORRELATION-ID ‘id1'‘ is the 
correlation identifier of the thread requesting that the CHECK 
PENDING state be set on or off. The CONNECTION-ID ‘id2' is 
the correlation identifier of the thread. The LUW-ID '‘id3' is the 
logical unit of work identifier of the thread. If the LUW-ID is an 
'*' ‘the thread has no LUW-ID. If not an ‘*', the value is a 
logical-unit-of-work-id that is assigned to the thread followed by 
an '=' sign followed by a token value that can be used in place 
of the logical-unit-of-work-id in any DB2 command that accepts 
a logical-unit-of-work-id as input. 


[ = : ~~ {Internal DB2 Information ~~~ a 
This message is issued by the following CSECT(s): DSNUGCKP 


bis at ha End of Internal DB2 Information eee | 


Severity: 4 (warning) 


DSNU9721! 


System Action: Processing continues. 


Problem Determination: The utility being processed requested 
the setting of CHECK PENDING either on or off. The updating of 
the STATUS column of SYSTABLESPACE, and of the 
CHECKFLAG and CHECKRID columns of SYSTABLES and 
SYSTABLEPART, failed. Processing continues normally. 
However, those columns for the rows being updated now 
contain invalid values. Subsequent utility processing will 
ignore these values, and the next setting or resetting of CHECK 
PENDING for that table space will correct the error in one of the 
following ways: 


e Ifthe table space is set to CHECK PENDING and the catalog 
fields are in error, the scope of CHECK PENDING will be 
escalated in the catalog. (The STATUS column of 
SYSTABLESPACE will be set to 'P', and the CHECKFLAG 
and CHECKRID columns of SYSTABLES and 
SYSTABLEPART will be set to 'C' and binary zeros.) 


¢ Ifthe table space is set to NOT CHECK PENDING and the 
catalog fields are in error, the scope of CHECK PENDING 
will be set off in the catalog. (The STATUS column of 
SYSTABLES will set to an 'A‘, and the CHECKFLAG and 
CHECKRID columns of SYSTABLES and SYSTABLEPART 
will be set to blanks.) 


After the catalog fields are corrected, the setting or resetting of 
CHECK PENDING will continue as specified. 


Usually message DSNT500! or DSNT5011 wil! also be issued, 
because the probable cause of the error is RESOURCE UNA- 
VAILABLE. If the reason for the failure was not RESOURCE 
UNAVAILABLE, an SVC dump will be requested and processing 
will continue normally. To determine the cause of the failure, 
refer to the dump listing and the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5, 31. 


DSNU972I — DSNUS94I 


DSNU9731 csect-name TABLESPACE dbname.tsname IS NOT 


CHECK PENDING CORRELATION-ID id1 
CONNECTION-ID id2 LUW-ID id3 


Explanation: This message is sent to the console when 
TABLESPACE 'tsname' was set NOT CHECK PENDING. The 
CORRELATION-ID 'id1' is the correlation identifier of the 
thread requesting the CHECK PENDING state be set off. The 
CONNECTION-ID ‘id2' is the correlation identifier of the thread. 
The LUW-ID 'id3' is the logical-unit-of-work identifier of the 
thread. If the LUW-ID is an ‘'*', the thread has no LUW-ID. If not 
an '*', the value is a logical-unit-of-work-id that is assigned to 
the thread followed by an '=' sign followed by a token value 
that can be used in place of the logical-unit-of-work-id in any 
DB2 command that accepts a fogical-unit-of-work-id as input. 


[ — Internal DB2 Information ~~ —<— | 
This message is issued by the following CSECT(s): DSNUGCKP 


[eae ee End of tnternal DB2 Information _ id 


Severity: 0 (informational) 
System Action: Processing continues. 


User Response: Refer to Section 4 (Volume 2) of Adminis- 
tration Guide for a discussion of the NOT CHECK PENDING 
operation. 


Probiem Determination: Refer to Section 4 (Volume 2) of 
Administration Guide for a discussion of the NOT CHECK 
PENDING operation. 


DSNUS93!1 IMAGE COPY RESTORE TERMINATED. 


Explanation: Image Copy Restore has not successfully com- 
pleted processing. 


i ~ Internal DB2 Information ~——_~—— 
This message is issued by the following CSECT(s): DSNUGICR 


aes End of Internal DB2 Information Spee 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Examine the previous error message 
of the application program. 


DSNUSS41 IMAGE COPY RESTORE COMPLETED SUCCESS- 


FULLY. 


Explanation: Image Copy Restore has successfully completed 
processing. 


it Internal DB2 Information ~~ 
This message is issued by the following CSECT(s): DSNUGICR 


| __sEnd of Internal DB2 Information ___—_—d 


Severity: 0 (informational) 


System Action: Processing terminates. 


DB2 Messages 3-223. 


DSNU995!1 — DSNU999I 


DSNUS95i VSAM PUT ERROR, RPLERREG = return-code, 


RPLERRCD = reason-code 


Explanation: VSAM PUT has failed with the indicated 
‘return-code' and 'reason-code'. 


; an Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNUGICR 


eer End of Internal DB2 information kee ete ce 


Severity: 8 (error) 
System Action: Processing terminates. 
User Response: Notify system programmer. 


System Programmer Response: Follow standard VSAM diag- 
nostic procedure. Refer to MVS/XA VSAM Administration 
Guide. 


DSNUS96I VSAM OPEN ERROR, ACBERRFLG = error-code 


Explanation: VSAM OPEN has failed with the indicated ACB 
‘error-code'. 


| ~ Internal DB2 Information as | 
This message is issued by the following CSECT(s): DSNUGICR 


i ee End of Internal DB2 Information iets le ens] 


Severity: 8 (error) if error is greater than or equal to 128; oth- 
erwise, 4 (warning) 


System Action: Processing terminates if error code is greater 
than or equal to 128; otherwise, processing continues normally. 


User Response: Notify system programmer. 


System Programmer Response: Follow standard VSAM diag- 
nostic procedure. Refer to MVS/XA VSAM Administration 
Guide. 
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DSNU9971 OUTPUT DATA SET NAME = data-set-name 


Explanation: The indicated 'data-set-name' is used for output. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNUGICR 


a eeree End of Internal DB2 Information oe ee 


Severity: 0 (informational) 


DSNU998I INPUT DATA SET NAME = data-set-name 


Explanation: The indicated 'data-set-name’ is used for input. 


ao ee ee Internal DB2 Information ee oe 
This message is issued by the following CSECT(s): DSNUGICR 


{| End of Internal DB2 information 


Severity: 0 (informational) 


DSNU9991 START OF IMAGE COPY RESTORE FOR JOB job- 


name step-name 


Explanation: This message indicates that Image Copy Restore 
has started processing. 


aes Internal DB2 Information Se 
This message is issued by the following CSECT(s): DSNUGICR 


on End of Internal DB2 information ge 


Severity: 0 (informational) 


System Action: Image Copy Restore starts processing. 


DSNVO29E — DSNV402I 





Agent Services Manager Messages (DSNV...) 


DSNV029E LOAD MODULE module-name DOES NOT HAVE 


AMODE(31) ATTRIBUTE 


Explanation: During DB2 startup, Agent Services establishes 
the tasking structure for the control and resource manager 
address spaces. Three load modules, DSNVEUS3, DSNVEUS4, 
and DSNVRCT, are loaded and attached as the control pro- 
grams for each subtask created. In the MVS/XA environment, 
all three load modules must have been link-edited with the attri- 
butes AMODE(31) and RMODE(ANY). At feast one of the 
modules did not have the 31-bit addressing attribute when it 
was loaded. The 'module-name' in the error message is the 
alias name of the first load module whose addressing mode 
was invalid. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNVASIM 


Peta cee End of Internal DB2 Information pte taal 


System Action: DB2 startup is terminated. 


System Programmer Response: Verify that all installation and 
maintenance activities against these modules were executed 
using SMP, that the JCLIN for SMP includes the correct AMODE 
and RMODE control statements, and that the Linkage Editor 
provided with the Data Facility Product (DFP) for MVS/XA was 
invoked by SMP for the link-edits. Correct the procedure or JCL 
which caused the error and rerun the necessary SMP jobs. 


Operator Response: Notify the system programmer of the 
failure. 


Problem Determination: A DB2 dump was requested to an 
MVS/XA SYS1.DUMP data set. 


Load module names and aliases are as follows: 


Load module Alias 

DSNVEUS3 DSNVEU3I 
DSNVEUS4 DSNVEU4I 
DSNVRCT DSNVRCTI 


The MVS/XA service aid AMBLIST provides Linkage Editor 
module attributes in the summary section of the LISTLOAD 
function output. 


DSNVOS6E DB2 ABNORMAL TERMINATION 
REASON = xxxxxxxx 


Explanation: The DB2 subsystem is being abnormally termi- 
nated, because an error that cannot be corrected has occurred. 
This message, which.is not automatically deleted from the oper- 
ator console, is issued during DB2 abnormal termination. 
"REASON ' is the subsystem termination reason code. If DB2 
abnormal termination is invoked multiple times, the subsystem 
termination reason code that accompanies this message is the 
reason associated with the first invocation. For additional infor- 
mation, look up the reason code in “Section 4. DB2 Codes” on 
page 4-1. 


| internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNVATRM 


Te eee End of Internal DB2 Information eee | 


System Action: Abnormal termination processing continues. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: This message is accompanied 
by one or more dumps. Obtain a copy of SYS1.LOGREC after 
DB2 completely terminates; also obtain a copy of the SVC 
dump(s). Refer to Section 5 of Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 


DSNV401I DISPLAY THREAD REPORT FOLLOWS — 


Explanation: This message is always generated as the title for 
the -DISPLAY THREAD command report output. it precedes the 
other messages generated by this command. 


The series of messages DSNV402I through DSNV4051 provide 
the formatted report for the -DISPLAY THREAD TYPE(ACTIVE) 
when the status of active threads is requested. 


The series of messages DSNV444I through DSNV448I augment 
the formatted report for the -DISPLAY THREAD TYPE(ACTIVE) 

when LOCATION or LUWID keywords are used to show distrib- 
uted activity. 


| Interna! DB2 Information Ree ee | 
This message is issued by the following CSECT(s): DSNVDTM 


[he ee oe End of Internal DB2 Information pee ee | 


System Action: Processing continues normally. 


DSNV402i =ACTIVE THREADS-. 


Explanation: This message precedes the listing of active 
threads. 


The series of messages DSNV402I through DSNV4051 provide 
the formatted report for the -DISPLAY THREAD TYPE(ACTIVE) 
when the status of active threads is requested. 


The series of messages DSNV444I through DSNV448I augment 
the formatted report for the -DISPLAY THREAD TYPE(ACTIVE) 
when LOCATION, LUWID, or DETAIL keywords are used to show 
distributed activity. 


| Internal DB2 Information a “al 
This message is issued by the following CSECT(s): DSNVDTM 


Pees End of Internal DB2 Information ee 


System Action: Processing continues normally. 


DB2 Messages 3-225 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


DSNV4031 — DSNV406I 


DSNV4031 NAME ST A REQ 


ID AUTHID PLAN ASID 


Explanation: The column headings for the list of threads gen- 
erated by the -DISPLAY THREAD TYPE(ACTIVE) command are 
displayed. 


The message number and subsystem recognition character are 
not included in this message. 


| internal DB2 Information 
This message is issued by the following CSECT(s): DSNVDTM 


aera eeervers End of Internal DB2 Information eee 


System Action: Processing continues normally. 


DSNV404i name status act-ind req-ct 


corr-id auth-id pname_ asid 


Explanation: This message, in combination with messages 
DSNV402 and DSNV403, comprise the response to the -DISPLAY 
THREAD TYPE(ACTIVE) command. It provides the status infor- 
mation on an active thread, where: 


name A 1- to 8-character variable representing 
the ‘connection name' used to establish 
the thread. If the thread has a Status of 
'D', the connection name may be either the 
connection name for the allied address 


space or the DB2 subsystem name. 


A 1- or 2- character connection status code 
with the following values defined: 


N The thread is in either IDENTIFY or 
SIGNON status. 

QT The CREATE THREAD request has 
been queued. The associated 
allied task is placed in a wait state. 

T An allied, non-distributed thread 
has been established (plan allo- 
cated). 

TR An allied, distributed thread has 
been established and is requesting 
data from another location. 

RA The thread is performing a remote 

access on behalf of a request from 

another location. 

The thread is queued for termi- 

nation as a result of the termination 

of the associated allied task. If this 
thread is also the last (or only) DB2 
thread for the address space, the 
associated allied task is placed ina 
wait state. 

D The thread is in the process of ter- 
mination as a result of the termi- 
nation of the associated allied task. 
If this thread is also the last (or 
only) DB2 thread for the address 
space, the associated allied task is 
placed in a wait state. 


status 


QD 


An asterisk if the thread is active within 
DB2, blank otherwise. 


act-ind 


req-ct A wraparound counter to show the number 


of DB2 requests. 
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corr-id A 1- to 12-character variable representing 
the recovery ‘correlation-id' associated 


with the thread. 


The authorization ID associated with a 
signed-on connection. If not signed-on, this 
field is blank. 


authorization ID 


pname A 1- to 8-character variable representing 
the plan name associated with the thread. 
If a thread has not been established, this 


field is blank. 


A 1- to 4-character hexadecimal number 
representing the ASID of the home address 
space. 


asid 


The message number and subsystem recognition character are 
not included in this message. 


fae ee we Internal DB2 Information a a 
This message is issued by the following CSECT(s): DSNVDTM 


ae End of Internal DB2 Information id 


System Action: Processing continues normally. 


Problem Determination: If you have active threads with 'QD' 
or 'D' status codes, the information in message DSN32011 can 
be used to diagnose a possible DB2 problem. 


DSNV4051 DISPLAY ACTIVE REPORT COMPLETE 


Explanation: This message follows messages DSNV402!I 
through DSNV404I augmented by the series of messages 
DSNV444l through DSNV448I when LOCATION and/or DETAIL 
keywords are used to show distributed activity. It indicates that 
the -DISPLAY THREAD TYPE(ACTIVE) report has completed 
successfully. 


The message number and subsystem recognition character are 
not included in this message. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNVDTM 


tee oe End of Internal DB2 Information Soe piereg | 


System Action: Processing continues normally. 


DSNV406i INDOUBT THREADS- 


Explanation: This message precedes the listing of indoubt 
threads. 


The series of messages DSNV406I through DSNV409! provide 
the formatted report for the -DISPLAY THREAD TYPE(INDOUBT) 
command when the status of indoubt threads is requested. 


| ; aa Internal DB2 Information ~~ ne | 
This message is issued by the following CSECT(s): DSNVDTM 


an End of Internal DB2 Information a ae 


System Action: Processing continues normally. 


DSNV4071 NAME ID PLAN NID 


Explanation: This and message DSNV406! form the heading for 
the listing of indoubt threads. Items in this part of the heading 
are: 


NAME The associated connection-name. 


ID The associated corretation-id. 
PLAN The associated plan-name. 
NID The associated net-node.number. 


See message DSNV408I for descriptions of these items. 


The message number and subsystem recognition character are 
not included in this message. 


= Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNVDTM 


Ne ter ees he! End of Internal DB2 Information poe es A 


System Action: Processing continues normally. 


DSNV408! name corr-id pname net-node.number 
Explanation: Status information on an indoubt thread is fisted: 


name A 1- to 8-character variable that represents the con- 
nection name used to establish the thread. 


corr-id A 1- to 12-character variable that represents the 
recovery correlation ID associated with the thread. 
pname A 1- to 8-character variable that represents the plan 


name associated with the thread. 
net-node.number 
A 1- to 25-character variable that represents the 
recovery network ID associated with the indoubt 
thread. This recovery value is the concatenation of 
the following values: 
net-node The network-node name that identifies 
the originating system from which the 
transaction was generated. 
The hexadecimal number assigned to this 
thread by the originating system. 


number 


The message number and subsystem recognition character are 
not included in this message. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNVDTM 


a End of Internal DB2 Information eee | 


System Action: Processing continues normally. 


DSNV4091 DISPLAY INDOUBT REPORT COMPLETE 


Explanation: This message follows messages DSNV406! 
through DSNV408I and indicates that the -DISPLAY THREAD 
TYPE(INDOUBT) report was generated successfully. 


The message number and subsystem recognition character are 
not included in this message. 


DSNV407I — DSNV412I 


P — Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNVDTM 


{ End of Internal DB2 Information ___——_— 


System Action: Processing continues normally. 


DSNV410i NO ACTIVE CONNECTION FOUND FOR 


NAME = connection-name 


Explanation: The -DISPLAY THREAD TYPE(ACTIVE) command 
was unable to find an allied address space associated with 
‘connection-name'. This message is generated once for each 
connection name requested. 


Internal DB2 information 7 ‘| 
This message is issued by the following CSECT(s): DSNVDTM 


We ae ere End of internal DB2 Information aes 


System Action: Command processing continues. 


DSNV411I NO ACTIVE THREADS FOUND FOR 


NAME = connection-name 


Explanation: The -DISPLAY THREAD TYPE(ACTIVE) command 
was unable to locate any active threads associated with 
‘connection-name'. This message indicates one or more 
active allied address spaces were found to exist, but no threads 
were found. This message is generated once for each con- 
nection name for which no threads were found. 


(> <= Internal DB2 Information a ae ae 
This message is issued by the following CSECT(s): DSNVDTM 


a End of Internal DB2 Information se S| 


System Action: Command processing continues. 


DSNV412! csect-name NO INDOUBT THREADS FOUND FOR 


NAME = connection name 


Explanation: In this message, 'csect-name' is the name of the 
command program CSECT that issued the message. 'NAME' is 
the connection name specified on the command. 


The named command was unable to locate any indoubt threads 
associated with the 'connection name'. This message is gen- 
erated once for each 'connection name' for which no threads 
were found. 


| Internal DB2 Information ~~" “| 


This message is issued by the following CSECT(s): DSNVDTM, 
DSNVRIM 


een oes End of Internal DB2 Information | 


System Action: Command processing continues. 


DB2 Messages 3-227 


DSNV413I — DSNV418I 


DSNV413) csect-name verbname pkwname TERMINATED, 


DEFAULT UNAVAILABLE 


Explanation: The message indicates that the named command 
has abnormally terminated. A 'connection name' was not sup- 
plied with the command, and a default is not provided. If the 
command was entered from an MVS console, the 
‘CONNECTION NAME' parameter must be supplied with the 
command. No default is provided. 


csect-name The name of the command program CSECT that 
issued the message. 

The command verb as entered by the requestor. 
The command primary keyword as entered by the 
requestor. 


verbname 
pkwname 


| ~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNVDTM, 
DSNVRIM 


Eos te ee End of internal DB2 Information ee 


System Action: Command processing terminates. 


Operator Response: Reenter the command specifying a 
‘connection name'. 


DSNV4141 THREAD xxx COMMIT SCHEDULED 


Explanation: inthis message, 'xxx' is the recovery identifier 
specified with the -RECOVER INDOUBT command to identify the 
indoubt thread and is one of the following: 


ID= Indicates the recovery correlation-id specified 
with the command. 
NID= Indicates the recovery network-id specified with 


the command. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNVRIM 


a End of Internal DB2 Information to I 


System Action: The thread specified on the -RECOVER 
INDOUBT command is scheduled for COMMIT recovery action. 


DSNV415I THREAD xxx ABORT SCHEDULED 


Explanation: In this message, 'xxx' is the recovery identifier 
specified with the -RECOVER INDOUBT command to identify the 
indoubt thread and is one of the following: 


ID= indicates the recovery correlation-id specified with 
the command. 

NID = indicates the recovery network-id specified with the 
command. 


The thread specified on the -RECOVER INDOUBT command is 
scheduled for ABORT recovery action. 


= Internal DB2 Information =. 
This message is issued by the following CSECT(s): DSNVRIM 


| s End of internal DB2 Information 


3-228 DB2 Messages and Codes 


System Action: Command processing continues. 


DSNV416I THREAD NID = net-node.number IS INVALID 


Explanation: In this message, 'net-node' is the recovery 
‘network-id' specified with the command. 


The -RECOVER INDOUBT command (NID = net-node.number) 
determined that the input format for the specified network-id is 
invalid. 


| internal DB2 Information = “| 
This message is issued by the following CSECT(s): DSNVRIM 


eee End of Internal DB2 Information Se ee ee 


System Action: Command processing continues. 


Operator Response: Prior to reentering the command, ensure 
that the network-id entered is in the correct format as specified 
on the -RECOVER INDOUBT command. 


DSNV417I THREAD xxx NOT FOUND 


Explanation: In this message, 'xxx' is the recovery identifier 
specified with the -RECOVER INDOUBT command to identify the 
indoubt thread and is one of the following: 


ID= Indicates the recovery correlation-id specified with 
the command. 

NID= Indicates the recovery network-id specified with the 
command. 


The -RECOVER INDOUBT command was unable to locate the 
specified thread to be scheduled for recovery. Either the 
thread identifier is incorrect, or the thread no longer resides 
within an indoubt state. 


(.> *) <—* Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNVRIM 


eeteeette cue ot End of internal DB2 Information eer: 


System Action: Command processing continues. 


Operator Response: Prior to reentering the command, ensure 
that the thread still resides within an indoubt state. 


DSNV4181 RECOVER INDOUBT REJECTED FOR ID= 


correlation-id 


Explanation: in this message, 'ID=' indicates the recovery 
‘correlation-id' specified with the command. 


The -RECOVER INDOUBT command determined that more than 
one 'network-id' is associated with the specified 
‘correlation-id'. No recovery action is taken against the 
indoubt threads associated with the 'correlation-id'. 


[ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNVRIM 


eS et End of Internal DB2 Information eee 


System Action: Command processing continues. 


Operator Response: To indicate the specific indoubt thread to 
be scheduled for resolution, the 'network-id' associated with 
the thread must be specified. 


DSNV4191 NO ACTIVE CONNECTIONS FOUND 


Explanation: The -DISPLAY THREAD command found no active 
allied address spaces within the system. This message is gen- 
erated when the command requests thread information for all 
(*) active (TYPE = ACTIVE) connections within the system, but 
no active connections currently exist. 


peor =~ a internal DB2 Information le eae | 
This message is issued by the following CSECT(s): DSNVDTM 


eee eens End of Internal DB2 Information beable tate 


System Action: Command processing continues. 


DSNV4201 


Explanation: The -DISPLAY THREAD command found no 
indoubt threads within the system. This message is generated 
when the command requests information about all (") threads 
currently residing within an indoubt state (TYPE = INDOUBT) 
within the system, but no threads currently exist within this 
state. 


| Internal DB2 Information ~~ =. | 
This message is issued by the following CSECT(s): DSNVDTM 


Seco End of Internal DB2 Information | 


System Action: Command processing continues. 


NO INDOUBT THREADS FOUND 


DSNV421i DISPLAY ACTIVE TERMINATED WITH MAX LINES 


Explanation: This message indicates the -DISPLAY THREAD 
TYPE(ACTIVE) report was truncated. The report was generated 
in response to a command from an MVS console and more than 
252 active threads were eligible for display. 


The message number and subsystem recognition character are 
not included in this message. 


b ; internal DB2 Information | 
This message is issued by the following CSECT(s): DSNVDTM 


= End of Internal DB2 Information | 


System Action: The truncated report is written to the MVS 
console. 


Operator Response: Reissue the -DISPLAY THREAD request 
specifying a specific connection name. 


DSNV422i DISPLAY INDOUBT TERMINATED WITH MAX 


LINES 


Explanation: This message indicates the -DISPLAY THREAD 
TYPE(INDOUBT) report was truncated. The report was gener- 
ated in response to a command from an MVS console and more 
than 252 indoubt threads were eligible for display. 


The message number and subsystem recognition character are 
not included in this message. 


DSNV419I — DSNV4451 


[ao ee Internal DB2 Information aaa 
This message is issued by the following CSECT(s): DSNVDTM 


ee End of Internal DB2 Information oe 


System Action: The truncated report is written to the MVS 
console. 


Operator Response: Reissue the -DISPLAY THREAD request 
specifying a specific connection name. 


DSNV4231 DISPLAY THREAD MESSAGE POOL SIZE 


EXCEEDED 


Explanation: The virtual storage requirement needed to gen- 
erate a -DISPLAY THREAD response display exceeded the 
maximum size of the message buffer pool. 


[- Internal DB2 Information : a | 
This message is issued by the following CSECT(s): DSNVDTM 


an End of Internal DB2 Information ee ar tel 


System Action: Processing is terminated. 


User Response: Reissue the -DISPLAY THREAD request speci- 
fying either TYPE(ACTIVE) or TYPE(INDOUBT). 


Operator Response: Refer to User Response. The operator 
may also limit the display size by specifying a connection name 
in the command. 


DSNV4441_  luw-id =token ACCESSING DATA AT. 


Explanation: This message follows a DSNV404I message for 
each thread that has been distributed to other locations when a 
non-detail display is specified. This message gives the logical- 
unit-of-work identifier for the distributed thread followed by an 
‘= ' sign followed by a token that can be used in place of luw-id 
in any DB2 command that accepts luw-id as input. Message 
DSNV446l follows with the names of the locations associated 
with this 'luw-id'. 


luw-id = token 
The 'luw-id' that is assigned to the thread followed 
by an '=' sign followed by a token value which can 
be used in place of the 'luw-id'in any DB2 command 
that accepts luw-id as input. 


The message number and subsystem recognition character are 
not included in this message. 


ae Internal DB2 Information eae 
This message is issued by the following CSECT(s): DSNVDTM 


[eee End of Internal DB2 Information beeen 


System Action: Command processing continues. 


DSNV445I luw-id =token ACCESSING DATA FOR location 


Explanation: This message follows a DSNV404I message for a 
database access thread when a non-detail display is specified. 
This message displays the logical-unit-of-work identifier 
assigned to the database access thread. 
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DSNV446I — DSNV454I 


luw-id =token 
The 'luw-id' that is assigned to the thread followed 
by a 'token' which may be used in place of the 
‘luw-id' in any DB2 command that accepts 'luw-id' 


as input. 
location The 'location' name assigned to the requesting site. 


The message number and subsystem recognition character are 
not included in this message. 


[ ana Internal DB2 information ~~ ——_— =] 
This message is issued by the following CSECT(s): DSNVDTM 


a End of Internal DB2 Information ee | 


System Action: Command processing continues. 


DSNV446I__silocation-i location-j ... 


Explanation: This message is a continuation of message 
DSNV444I to complete the list of location-i. 


Identifies the name of a remote DB2 sub- 
system at which data is being accessed. 


jocation-i 


A location-i identifier is repeated for each 
DB2 subsystem at which data is being 
accessed. 


The message number and subsystem recognition character are 
not included in this message. 


| ————~_ Internal DB2 Information a 7 — 4 
This message. is issued by the following CSECT(s): DSNVDTM 


ace ee End of Interna! DB2 Information Boag 


System Action: Command processing continues. 


DSNV4471 -LOCATION SESSID A ST TIME 


Explanation: This message forms the heading for the listing of 
distributed active threads in message DSNV448I. Items in this 
part of the heading are: 


LOCATION Heading for the associated location names. 

SESSID Heading for the associated VTAM-defined 
session identifiers. 

A Heading for the associated active indicators. 

ST Heading for the associated status indicators. 

TIME Heading for the associated timestamps. 


See message DSNV448!I for descriptions of these items. 


The message number and subsystem recognition character are 
not included in this message. 


os Internal DB2 Information es 
This message is issued by the following CSECT(s): DSNVDTM 


ea End of internal DB2 Information _ 


System Action: Processing continues normally. 
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DSNV448! location sessid active status time 


Explanation: This message follows the DSNV447! message for 
a database access thread or distributed allied thread when a 
detail display is specified. This message is displayed for each 
conversation connected to the thread. It lists detailed informa- 
tion about the conversations associated with the thread. 


location The location name of the DB2 subsystem that 
is doing work on behalf of the DB2 subsystem 
that originated the transaction. 

sessid The VTAM-defined session instance identifier 
of the session on which the conversation is 
executing. Zeroes if session identifier is not 

_applicable. 

active A 'V' if the conversation is active within 
VTAM, 'W' if the conversation is suspended in 
DB2 waiting for VTAM notification that the 
function is complete, blank otherwise. 

status Status of the conversation. 
$s Sending 

¢ At the requesting site, this indi- 
cates that the conversation can 
send requests to the server. 

e Atthe server site, this indicates 
that the conversation is sending 
or preparing to send a response. 

R Receiving 

* At the requesting site, this indi- 
cates that the conversation is 
receiving or waiting to receive a 
response from a request. 

e At the server site, this indicates 
that the conversation is receiving 
a request. 

A Conversation in allocation. 
D Conversation in deallocation. 
Blank otherwise. 
time The timestamp (yydddhhmmssth) of the last 


message sent or received on the conversation. 


The message number and subsystem recognition character are 
not included in this message. 


| ~~ _ Internal DB2 Information ~~ a 
This message is issued by the following CSECT(s): DSNVDTM 


Ps eee End of Internal DB2 tnformation eae Aol 


System Action: Command processing continues 


DSNV4541 LOCATION OR LUWID KEYWORD INVALID WHEN 


DDF NOT STARTED 


Explanation: The -DISPLAY THREAD TYPE(ACTIVE) command 
was issued with the keyword LOCATION or LUWID and it was 
found that the distributed data facility (DDF) was not started. 
The LOCATION or LUWID keyword can be used only if DDF is in 
operation. 


[ oe ea Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNVDTM 


[ie eee ee End of Internal DB2 Information oe cee gd 


System Action: Command processing is complete. 


DSNV455I DETAIL KEYWORD REQUIRES LOCATION OR 


LUWID KEYWORD 


Explanation: The -DISPLAY THREAD TYPE(ACTIVE) command 
was issued with the keyword DETAIL, but without the keyword 
LOCATION or LUWID. This message is a warning that the 
DETAIL keyword has no meaning without one of the other two 
DDF keywords. 


| Internal DB2 information — 
This message is issued by the following CSECT(s): DSNVDTM 


Woe oe End of Interna! DB2 Information eer 


System Action: Command processing continues. 


Operator Response: Re-enter the command with the correct 
syntax. 


DSNV4551 — DSNV456l 


System Programmer Response: Re-enter the command with 
the correct syntax. 


Problem Determination: The syntax of the -DISPLAY THREAD 
command is described in the DB2 publication Command and 
Utility Reference. 


DSNV4561 INVALID PARAMETER WITH LUWID KEYWORD 


luwid-parameter 


Explanation: The -DISPLAY THREAD TYPE(ACTIVE) command 
was issued with the keyword LUWID and its required parameter 
list. However, one of the parameters was found to be syntac- 
tically invalid as a logical-unit-of-work identifier. 


[~ as — Internal DB2 information ~— tet aoa 
This message is issued by the following CSECT(s): DSNVDTM 


fis Sees End of Internal DB2 Information eas | 


System Action: Command processing is complete. 


Operator Response: Re-enter the command specifying valid 
LUWID values. 


System Programmer Response: Re-enter the command speci- 
fying valid LUWID values. 


Problem Determination: The syntax of the -DISPLAY THREAD 
command is described in the DB2 publication Command and 
Utility Reference. 
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Instrumentation Facility Messages (DSNW...) 


DSNW001l ASYNCHRONOUSLY GATHERED DATA IS BEING 


FORMATTED IN THIS DUMP 


Explanation: The subsystem formatting exit is not using DB2 
summary dump records for formatting. The formatted control 
blocks may not contain the same values as they did at the time 
of the error. 


= Internal DB2 Information ie 
This message is issued by the following CSECT(s): DSNWDPRD 


| End of internal DB2 Information ______—_— 


System Action: Dump formatting continues. 


System Programmer Response: [If you want DB2 summary 
dump records to be used, do not specify the 'SUMDUMP=NO' 
operand on the dump control card. 


DSNWO002I SUMMARY DUMP RECORDS ARE BEING FOR- 


MATTED IN THIS DUMP 


Explanation: The subsystem formatting exit is using DB2 
summary dump record information to format its control blocks. 


| ~ Internal DB2 Information Tae 5) 
This message is issued by the following CSECT(s): DSNWDPRD 


{ End of Internal DB2 Information ke ell 


System Action: Dump formatting continues. 


System Programmer Response: If you do not want DB2 
summary dump records to be used in formatting, specify the 
‘SUMDUMP=NO' and 'SUBSYS= subsystem name' on the 
dump control card. Both operands are required. 


DSNW004i ONE OR MORE INVALID OPERANDS WERE 
FOUND ON THE DSNWDMP CONTROL CARD. 


SUBSYSTEM FORMATTING TERMINATED 


Explanation: An invalid operand was found on the dump 
control card. The operand was not 'SG', 'LG', 'SA', 'AA', or 
‘ALL'. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWDPRD 


ee End of Internal DB2 Information tee ee Bel 


System Action: Control returns to AMDPRDMP or IPCS to ter- 
minate the exit. 


System Programmer Response: Correct the dump control card 
operand specified by message DSNW0071. 


DSNW005} DUMP FORMATTER WORK BUFFER (DSNWDBUF) 


CANNOT BE LOCATED 


Explanation: The subsystem formatting exit could not locate its 
work buffer. 


a —  _ Internal DB2 Information iG tea, | 
This message is issued by the following CSECT(s): DSNWDPRD 


ote es End of Internal DB2 Information ty tee es, 


System Action: Control returns to AMDPRDMP or IPCS to ter- 
minate the exit. 


System Programmer Response: Increase the region size. 


DSNWO06! THE ERLY BLOCK CANNOT BE ACCESSED OR IT 


IS INVALID 


Explanation: The subsystem formatting exit could not locate its 
anchor block. 


[= se Internal DB2 Information SH 
This message is issued by the following CSECT(s): DSNWDPRD 
a ae End of Internal DB2 Information ee 


System Action: Control returns to AMDPRDMP or IPCS to ter- 
minate the exit. 


System Programmer Response: Specify 'SUBSYS=subsystem 
name', 'SUMDUMP=NO' on the dump control card. The sub- 
system name should have between 1 and 4 characters. 


DSNW007I THE FOLLOWING OPERAND SPECIFIED ON THE 


DSNWDMP CONTROL CARD IS INVALID: xxxx 


Explanation: The specified operand was not one of the valid 
dump control card operands. 


| rs internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWDPRD 


[tates Sateiend End of internal DB2 Information ake nk eee ae 


System Action: Control returns to AMDPRDMP or IPCS to ter- 
minate the exit. 


System Programmer Response: Check the dump contro! card 
operands. 


DSNW008i THE SCOM CANNOT BE ACCESSED OR ITIS 


INVALID 


Explanation: An error was encountered while trying to retrieve 
the SCOM. 


= ~ Internal DB2 Information ~~ ; “| 
This message is issued by the following CSECT(s): DSNWDPRD 


[oe eee End of Internal DB2 Information ef aie 2a 


System Action: Control returns to AMDPRDMP or IPCS to ter- 
minate the exit. 
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DSNWOO0SI — DSNW015i 


System Programmer Response: |f 'SUMDUMP=NO' was 
specified on the dump control card, omit this operand, and 
resubmit the job. Otherwise, specify this operand on the dump 
control card, and resubmit the job. 


DSNWO00S9! THE ADDRESS SPACE REQUESTED IS NOT 


AVAILABLE 


Explanation: The DB2 control blocks for the address space 
specified on the 'SA=asid' dump operand could not be 
located. 


pr =e = ~ Internal DB2 Information — - =~ = | 
This message is issued by the following CSECT(s): DSNWDPRD 


eee ees End of Internal DB2 Information eee sta 


System Action: Formatting continues if other dump operands 
were specified. 


System Programmer Response: Check the ASID specified on 
the 'SA=' dump operand. The ASID must be specified in 
hexadecimal. 


DSNWO0101 THE TRACE RMFT CANNOT BE ACCESSED OR IT 


IS INVALID 


Explanation: The DB2 trace table could not be located. 


| internal DB2 Information i aia 
This message is issued by the following CSECT(s): DSNWDPRD 


Le End of Internal DB2 Information bogie cee i) 


System Action: Formaiting of the DB2 trace table is bypassed, 
and formatting continues of any other requested dump 
segment. 


System Programmer Response: If 'SUMDUMP=NO' was 
specified on the dump control card, omit this operand. Other- 
wise, specify this operand on the dump control card. In either 
case, resubmit the job. 


DSNWO11l ALARGER REGION SIZE IS REQUIRED FOR THIS 


JOB 


Explanation: The subsystem formatting exit could not obtain a 
large enough work buffer to process the summary dump 
records. 


t — Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWDPRD 


eae End of Internal DB2 Information eee) 


System Action: Subsystem formatting continues. This 
message is accompanied by message DSNW012. 


System Programmer Response: Rerun the job, specifying a 
larger region size in the JCL. 
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DSNW013i DMPW NOT FOUND IN SUMMARY DUMP 


Explanation: The subsystem formatting exit was unable to 
locate the DMPW control block in the summary record portion of 
the dump data set. Because the DMPW provides the main 
anchor block for the dump formatter, processing is terminated. 


ae ~~ Internal DB2 Information ~~ a 
This message is issued by the following CSECT(s): DSNWDPRD 


——— End of Internal DB2 Information eee | 


System Action: Controj returns to AMDPRDMP or IPCS to ter- 
minate the exit. 


System Programmer Response: [f this is not a DB2 dump data 
set, specify 'SUBSYS = xxxx,SUMDUMP = NO' on the dump 
control card (where xxxx is the 1- to 4-character subsystem 
name), so that the subsystem formatting exit does not attempt 
to use summary dump data. 


DSNW014i REQUIRED SUMMARY DUMP RECORDS ARE NOT 
IN THIS DUMP. WILL ATTEMPT TO FORMAT 


FROM NON — SUMMARY DUMP 


Explanation: Expected data could not be found in the summary 
dump. This message is issued for information only. Dump for- 
matting continues. However, it will take longer, because a 
greater volume of data COMMAND PQUIT must be analyzed. 


| : Internal DB2 Information cee t ail 
This message is issued by the following CSECT(s): DSNWDPRD 


See End of Internal DB2 Information eee 


System Action: Formatting is attempted using the full dump 
instead of the summary dump. 


System Programmer Response: Though processing continues, 
this message is an indication of a problem, and should be 
pursued as such. 


DSNW015I SSCVT NOT LOCATED. CHECK THE SUBSYSTEM 


NAME ON THE CONTROL CARD 


Explanation: In a search through the SSCVT chain, a match of 
the subsystem name in the SSCVTs and the subsystem name on 
the control card was not found. 


[ts SS Internal DB2 information ss oi 
This message is issued by the following CSECT(s): DSNWDPRD 


eee End of Internal DB2 Information eee 


System Action: Formatting for the named subsystem is not 
done. 


Operator Response: Check the 'SUBSYS= ' operand on the 
control card. 


System Programmer Response: Correctly specify the sub- 
system name on the control card. 


DSNWO16| THE RMVT CANNOT BE ACCESSED OR IT IS 


INVALID 


Explanation: The subsystem formatting exit could not locate 
the RMVT. The RMVT is required for formatting the DB2 trace 
table and a number of other DB2 control blocks. 


ie Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWDPRD 


eee metas End of Internal DB2 Information ee 


System Action: Formatting of the DB2 trace table is bypassed, 
and formatting of other requested dump segments continues. 


System Programmer Response: If 'SUMDUMP=NO' was 
specified on the dump control card, omit this operand. Other- 
wise, try specifying this operand on the dump control card. In 
either case, resubmit the job. 


DSNWO017! MAXIMUM STACK LEVEL EXCEEDED 


Explanation: This condition is usually caused by the DB2 
control block formatter looping. The stack array is depleted 
and can no longer accommodate control blocks. 


— Interna! DB2 Information ~~ —~.. 
This message is issued by the following CSECT(s): DSNWDCBF 


ih End of Internal DB2 Information seh 


System Action: Dump formatting is terminated. 


System Programmer Response: Examine the control block 
chains to see if they are looping. If those chains are not 
looping, increase the dimension of the stack array. 


DSNW018l SUBSYS= NOT SPECIFIED ON THE CONTROL 


CARD OR MISSING. REQUIRED IF 
SUMDUMP = NO SPECIFIED 


Explanation: The 'SUMDUMP=NO' option was specified, but 
either the 'SUBSYS= ' operand is missing, or it was incorrectly 
specified. 


| Internal DB2 information ~— ———— a 
This message is issued by the following CSECT(s): DSNWDPRD 


—_—aa ee End of internal DB2 Information noe ae 


System Action: Dump formatting is terminated. 


Operator Response: Run the dump printing job after the error 
has been corrected. 


DSNW0201 UNSUCCESSFUL SEARCH FOR THE ERLY 


CONTROL BLOCK 


Explanation: The 'ERLY' control block could not be located in 
the dump. 


DSNW016i — DSNW025I 


| Internal DB2 Information 7 = 
This message is issued by the following CSECT(s): DSNWDPRD 


[iss = oe End of Internal DB2 Information _ 


System Action: Dump formatting is terminated. 


Operator Response: Check that the 'SUBSYS=' operand was 
correctly specified, and rerun the job. 


System Programmer Response: This message can mean that 
the 'ERLY' control block has been overlaid. Examine the full 
dump to determine whether the subsystem is present. If it is, 
you may be able to determine why the control block could not 
be located. 


DSNW022i THE RESIDENT TRACE WAS NOT ACTIVE AT THE 


TIME OF DUMP 


Explanation: Trace table formatting has been attempted, but 
no trace table existed at the time of the dump. 


| Internal DB2 Information 7 
This message is issued by the following CSECT(s): DSNWDCBF 


Nos at cates End of Internal DB2 Information ae 


System Action: Dump formatting continues with any other 
control blocks that were to be formatted. 


DSNW0231 THE TRACE TABLE ENTRY IS OUT OF SEQUENCE 


OR OVERLAID 


Explanation: A trace entry is overlaid by another trace entry of 
a different timestamp. This message is issued to flag an unrec- 
ognized trace entry. This can occur when the oldest entry in 
the table is the second half of a double entry. 


i — Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWDCBF 


Ps ee se End of Internal DB2 Information ee ee | 


System Action: Formatting of the trace table continues. 


DSNWO024l TRACE TABLE 


Explanation: The trace table follows. 


[Po > — += a Interna! DB2 information ee el 
This message is issued by the following CSECT(s): DSNWDCBF 


Wce ee oe eee End of internal DB2 Information as, 


System Action: Trace table formatting follows. 


DSNW0251 DUMP ACCESS ERROR ACCESSING THE TRACE 


TABLE IN THE DUMP 


Explanation: A nonzero return code was returned from the 
storage access routine when accessing the trace table. 
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DSNWO026! — DSNWO36I 


[ = Internal DB2 information | 
This message is issued by the following CSECT(s): DSNWDCBF 


———er End of Internal DB2 Information geese £3 


System Action: Trace table formatting is bypassed. 


System Programmer Response: Check the address and ASID 
of the trace table. 


DSNW026l CONTROL BLOCK SUMMARY (ALL ADDRESS 
SPACES) 

DSNW027i CONTROL BLOCK SUMMARY (SINGLE ADDRESS 
SPACE) 

DSNW028! CONTROL BLOCK SUMMARY (LONG FORM 
GLOBAL) 

DSNW0291 CONTROL BLOCK SUMMARY (SHORT FORM 
GLOBAL) 


Explanation: Messages DSNW026l through DSNW029! provide 
descriptive information regarding the type of formatting being 
produced. 


Ee es ee Internal DB2 Information | 


These messages are issued by the following CSECT(s): 
DSNWDPRD 


Doers! End of Internal DB2 Information ene el 


System Action: Dump formatting continues. 


DSNW030! DUMP ACCESS ERROR ACCESSING THE 


CONTROL BLOCK STRUCTURE TABLE IN THE 
DUMP 


Explanation: The control block structure table cannot be 
accessed from the dump. 


i. ee = internal DB2 Information as 
This message is issued by the following CSECT(s): DSNWDCBF 


oe aoe Je End of Internal DB2 Information ee 


System Action: Control block formatting is terminated. 
Operator Response: Notify the system programmer. 


’ System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DSNW0321 DUMP ACCESS ERROR ACCESSING ANCHOR 


CONTROL BLOCK 


Explanation: The anchor control block cannot be accessed 
from the dump. 


Internal DB2 Information = | 
This message is issued by the following CSECT(s): DSNWDCBF 


[| End of Internal DB2 Information ____——_| 


System Action: Control block formaiting is terminated. 


Operator Response: Notify the system programmer. 
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System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DSNW0331 BEGINNING FORMATTING 


Explanation: Formatting of DB2 control blocks is beginning. 


[— = 3s, + ws Internal DB2 Information So. 3 
This message is issued by the following CSECT(s): DSNWDHPP 


Ngee eee End of Internal DB2 Information ee, 


DSNW034I TRACE TABLE AND GLOBAL BLOCKS ALREADY 


DUMPED 


Explanation: An indicative dump is being requested. The DB2 
trace table and the global blocks have already been dumped 
with first dump (full dump) for this abend dump (SNAP) invoca- 
tion. These are, therefore, not dumped in the dump for this 
task. 


Internal DB2 Information a “| 
This message is issued by the following CSECT(s): DSNWDHPP 


Lo End of internal DB2 Information _ 


DSNW035i WARNING — NO TASK RELATED CONTROL 


BLOCKS FOR THIS TASK 


Explanation: The TCB for which the dump is being requested is 
not IDENTIFIED to DB2. Task-related control blocks are not 
dumped. The DB2 trace table and global blocks are dumped 
only if the 'SYSABEND' DD statement is present and only if this 
is the first of the dump(s) (full dump) for this abend dump 
(SNAP) invocation. 


~- . e Internal DB2 Information eH 
This message is issued by the following CSECT(s): DS(NWDHPP 


a End of internal DB2 Information gies 


System Action: No DB2 formatting is done for the specified 
task. 


DSNWO036I CONTROL BLOCKS FOR TASKS ASSOCIATED 


WITH THE ABOVE RECOVERY COORDINATOR 
TASK 


Explanation: The formatted blocks following this message are 
associated with TCBs that have IDENTIFIED to DB2 with the 
‘recovery coordinator = no' option. These TCBs may not have 
invoked SNAP, but they are associated with the TCB that did. 


Internal DB2 Information ae 
This message is issued by the following CSECT(s): DSNWDHPP 


chert Slee End of Internal DB2 Information tes a 


System Action: Related control blocks are dumped. 


System Programmer Response: Examine the control blocks for 
relevant information. ; 


DSNW0371 TASK RELATED CONTROL BLOCKS FOR THIS 


TASK 


Explanation: The formatted blocks following this message are 
associated with the TCB that is being dumped. 


[oo Internal DB2 Information ery eS 
This message is issued by the following CSECT(s): DSNWDHPP 


Pee eee ee End of Internal DB2 Information oe eecer || 


System Action: Relevant control blocks are dumped. 


System Programmer Response: Examine the control blocks for 
relevant information. 


DSNW038i END OF FORMATTING 


Explanation: Formatting of DB2 contro! blocks is completed. 


| Internal DB2 Information : 
This message is issued by the following CSECT(s): DSNWDHPP 


Dieeat es End of Internal DB2 Information eres | 


DSNW0391 SUBSYSTEM FORMATTING COMPLETE FOR THIS 


DUMP 


Explanation: The subsystem formatting routine has completed 
its processing for this dump data set. 


a Internal DB2 Information ~~ So alll 
This message is issued by the following CSECT(s): DINWDPRD 


[| End of Internal DB2 Information eaten 


DSNWO0401 = 'VVV'CONTROL BLOCK FORMATTER ERROR 
FLAGS 

X'80': FIELD EXPECTED TO BE ZERO IS 
NONZERO 

X'40': LAST BLOCK IN CHAIN DOES NOT POINT 
BACK TO PARENT BLOCK 

X'20': BLOCK NOT FOUND IN DUMP 

X'10': BLOCK LENGTH INCORRECT 

X'08': VERIFICATION CODE INCORRECT 

X'04': BLOCK CHAINED FROM THIS BLOCK NOT 
FOUND IN DUMP 

X'02': BLOCK CHAINED FROM THIS BLOCK HAS 
WRONG VERIFICATION CODE 

X'01': VALIDATION CONSTANT DOES NOT 
MATCH EXPECTED VALUE 


Explanation: The message DSNW040! appears at the beginning 
of a formatted dump. It defines the hexadecimal values associ- 
ated with the 'VVV=XX' keyword. This keyword is provided on 
the title line of each control block selected for formatting. It 
indicates any unusual conditions encountered during the vali- 
dation and format processing of the current control block struc- 
ture. 


DSNW037! — DSNW041I 


os Internal DB2 Information SS 
This message is issued by the following CSECT(s): DSNWDPRD 


| eee? End of Internal DB2 Information ee 


System Action: Dump formatting continues. 


System Programmer Response: All non-zero 'XX' values 
should be examined. If an error is indicated, the printout of the 
dump should be used for the problem documentation. 


Problem Determination: Possible errors include: 
X'80' 
X'40' 
X'20' 
X'04' 


The current state of the individual control block structures at 
the time of error might vary with the type of error invoived. 
Examine control block structures with one of these 'XX' values 
based on the specific ABEND code. 


Example: A X'04' associated with the referencing control block 
and the X'20' associated with the referenced contro! block may 
mean the ABEND occurred between the release of the refer- 
enced control block and re-initialization of the address within 
the referencing one. 


DB2 validation errors include: 
e X'10' 

e X'08' 

e X'02' 

e X'0Ot' 

These values indicate that a validation error occurred while for- 
matting the associated control block. 


For example, an X'08' associated with the referenced control 
block indicates the storage area has been overlaid or the 
address in the referencing control block is incorrect. Subse- 
quent examination of the values in this control block is not reli- 
able. 


DSNW041l THE TAB CANNOT BE ACCESSED OR IT IS 


INVALID 


Explanation: The DB2 trace table anchor block could not be 
located. 


[ees te Internal DB2 information a ee ee 
This message is issued by the following CSECT(s): DSNWDPRD 


[End of Internal DB2 Information ______——_| 


System Action: Formatting of the DB2 trace table is bypassed, 
and formatting of any other requested dump segment con- 
tinues. 


System Programmer Response: /f 'SUMDUMP=NO' was 
specified on the dump control card, omit this operand. Other- 
wise, specify this operand on the dump control card. In either 
case, resubmit the job. 


Refer to Section 4 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 
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DSNW049!1 — DSNWO053! 


DSNW049I OLDEST SLOT ADDRESS INVALID, FORMATTING 


TRACE TABLE FROM FIRST ENTRY 


Explanation: The next trace table entry location is invalid. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWDCBF 


et aes End of Internal DB2 Information | 


System Action: Dump formatting continues. 


System Programmer Response: The printout of the dump 
should be used for the problem documentation. 


Problem Determination: The Trace Anchor Block has been ini- 
tialized incorrectly, or overlaid during execution. 


DSNWO050I s NO SDWA/LOGREC, 
ABND =comp-reason,U = user-id, 


M = module,COMP = XYR00. vrm.comp-function 


Explanation: This message provides the default SVC dump title 
(SDUMP) associated with the SYS1.DUMP data set, when an 
SDWA was unavailable during recovery processing. The indi- 
vidual variable fields contain: 


Field Contents 

Ss DB2 subsystem recognition character. 

ABND The abend completion code, followed by the abend 
reason code. 


U The authorization-ID for the individual subsystem 
user. 

M The function recovery routine responsible for the 
dump. 

COMP The component-ID. 

vrm The DB2 version, release number, and modification 
level. 


comp-function 
The component-I!D function. 


For more information, refer to Section 5 of Diagnosis Guide and 
Reference. 


z= Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWDSDM 


een End of Internal DB2 Information ree eel 


System Action: Dump processing continues. 


System Programmer Response: Since the SDWA provides 
important diagnostic information to assist in problem determi- 
nation, the recovery environment at time of error should be 
examined to determine why an SDWA was not provided for this 
ABEND. 


In a non-recovery environment, there may be valid reasons for 
the lack of an SDWA. 


Problem Determination: In a recovery environment, Functional 
Recovery Routines (FRRs) are guaranteed an SDWA by 
Recovery Termination Manager (RTM). Therefore, the recovery 
routine is most likely an ESTAE recovery routine. The primary 
reason for an SDWA not being provided to an ESTAE routine is 
due to insufficient storage available during recovery proc- 
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essing. The region sizes allocated to the failing function should 
therefore be examined to insure sufficient storage is available. 


In a non-recovery environment, no SDWA is provided because 
only RTM can create one. 


DSNW051I ERROR DURING DUMP PROCESSING 


Explanation: This message is generated by the 'SDUMP dump 
data gathering service’ recovery routine when an error is 
encountered during dump processing. 


[a internal DB2 Information a 
This message is issued by the following CSECT(s): DSNWDSDM 


a End of internal DB2 Information ae Ee | 


System Programmer Response: This error is documented ina 
SYS1.LOGREC record. This message can be issued because of 
an error in the invocation of SDUMP, or because of an error in 
SDUMP itself, or during control block examination and access. 


System Action: Processing of the 'SUMLSTA' user storage 
areas is terminated, an SVC dump is requested, and control is 
returned to RTM. 


DSNW052i ERROR ENCOUNTERED DURING LOAD OR VALI- 
DATION OF A CONTROL BLOCK STRUCTURE 


TABLE MODULE 


Explanation: The DB2 dump formatting facility cannot be used 
to format control blocks. An error occurred during the DB2 
startup process while attempting to LOAD one of the Control 
Block Structures Table (CBDS) modules from the DB2 sub- 
system program library. 


Internal DB2 Information _ 
This message is issued by the following CSECT(s): DSNWOLDS 


[ert End of internal DB2 Information eee 


System Action: Subsystem startup processing continues. 


Operator Response: If intervention is desired, notify the 
system programmer. 


System Programmer Response: If intervention is desired, the 
DB2 subsystem can be terminated by either an MVS CANCEL 
command or a -STOP DB2 command. ff you are unable to 
resolve the problem, refer to the Section 5 of Diagnosis Guide 
and Reference for failure analysis procedures. 


Problem Determination: The modules must reside in a DB2 
program library named on the execution procedure used to 
start a DB2 subsystem address space. 


The named modules prohibit the use of the DB2 dump format- 
ting facility to format SVC dumps that occur during the current 
execution cycle of the DB2 subsystem. The named modules are 
not required for DB2 execution. 


DSNW0531 VRA DIAGNOSTIC INFORMATION REPORT 


Explanation: All DB2 diagnostic information in the Variable 
Recording Area (VRA) at the time of the error is extracted and 
displayed in this report. 


The address of the SDWA, the contents of SDWARA, and 
SDWARA’s hexadecimal offset into SDWA are also displayed. 
Individual diagnostic entries are identified by a hexadecimal 
VRA 'key', followed by the length of the subsequent data. Data 
fields are displayed in hexadecimal and EBCDIC formats. For 
further information, refer to Section 5 of Diagnosis Guide and 
Reference. 


‘aan Interna! DB2 Information SS ee 
This message is issued by the following CSECT(s): DSNWSDFR 


re eer End of Internal DB2 information a po eel 


System Action: Dump format processing continues. 


System Programmer Response: Individual VRA data entries 
can be associated with the corresponding subcomponent and 
ABEND code as defined in the Section 5 of Diagnosis Guide and 
Reference. 


DSNW0541 NO VRA DATA RECORDED IN SDWA 


Explanation: The SDWA obtained from the SYS1.DUMP data 
set contained no diagnostic information in the VRA. 


ee ieee Internal DB2 Information fF egy 
This message is issued by the following CSECT(s): DSNWSDFR 


a End of Internal DB2 Information ees 


System Action: VRA report generation is bypassed, dump 
format processing continues. 


System Programmer Response: If an error is indicated, the 
printout of the dump should be used for the problem documen- 
tation. Refer to Section 5 of Diagnosis Guide and Reference. to 
insure the initial ABEND indicates no VRA data is needed. If 
VRA data is needed, the abending DB2 subcomponent has 
failed to supply it. 


DSNWO0551 FORMAT ROUTINE UNABLE TO LOCATE SDWA 


Explanation: The MVS Summary Du mp Data Access Service 
Routine (IEAVTFRD) was unable to locate the SDWA in the 
summary data portion of the SYS1.DUMP data set. 


a Internal DB2 Information ee eS SS ol 
This message is issued by the following CSECT(s): DSNWSDFR 


a arora End of Internal DB2 Information Bese | 


System Action: VRA report generation is terminated and dump 
format processing continues. 


System Programmer Response: Take the appropriate action, 
as indicated in the next section. If an error is indicated, use the 
printout of the dump for problem documentation. 


Problem Determination: The SDWA is placed in the summary 
data portion of the SYS1.DUMP data set by AMDPRDMP or 
IPCS. !t indicates either CSA or Local Storage Residency. 


If the SDWA is not in the dump data set, no error is indicated. 


DSNW0541 — DSNWO6OI 


DSNWO056I VRA DIAGNOSTIC REPORT COMPLETE 


Explanation: The VRA Diagnostic Report is done. 


Internal DB2 Information So 
This message is issued by the following CSECT(s): DSNWSDFR 


ee ee End of Internal DB2 information ere | 


System Action: Dump format processing continues. 


DSNWO60! BEGIN SAVE AREA TRACE 


Explanation: This message identifies the start of the DB2 reg- 
ister Save Area Trace report which appears in the formatted 
section of a DB2 SVC Dump. The save areas for the current 
failing Agent execution block (EB), and all associated Agent 
EBs, are traced from the point of error and displayed in order of 
invocation. 


The format of this report is as follows: 
Save Area Identification 


The address and contents of each save area is displayed and 
identified by the invoking module. 


module-name service-level-identifier 


SA .oe» WO 1... HSA .... LSA.... 
RET .... EPA .... RO 
Rl... R2 2... RB 
R4 R5 R6 
R7 R8 RY 
R10 R11 R12 


module-name 
Identifies the module responsible for obtaining the 
save area as indicated in the DB2 Module Entry 
Point List (MEPL) at the time of the error. 


If the MEPL does not contain an entry that corre- 
sponds to the module Entry Point Address (EPA), 
this field is set to: 


MODULE INFORMATION UNAVAILABLE 


service-level-identifier 
The service level information associated with the 
module name is obtained from the corresponding 
module MEPL entry, and consists of the compilation- 
date and the PTF number of the latest maintenance 
applied. 


If no maintenance has been applied for this module, 
this field defaults to the Function Modification Identi- 
fier (FMID). 


SA Identifies the address and contents of each word of 
the save area and is displayed using the format and 
register abbreviation conventions defined by MVS 
SNAP. All save area data references indicate the 
primary address space at the time of execution. 


Execution Environment 


Displays the current execution environment at the time of error 
for the save areas that follow. This information is repeated each 
time the current Agent execution EB changed during proc- 
essing. 

CURRENT EB=address JOBNAME=name 


HASID=hasid PASID=pasid 
EXECUTION MODE=mode 
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address Address of the associated Agent EB. 


name The 8-character MVS jobname associated with the 
home address space. 

hasid Home address space identifier. 

pasid Primary address space identifier. 

mode Agent EB MVS execution mode: 
TCB Task Control Mode 
SRB Supervisory Request Mode 


Register Save Area Contents for Agent EBs 


The contents of the register save area chains for the current 
failing Agent EB, and all suspended Agent EBs at the time of 
error, are displayed using the save area (SA) format. 


REGISTERS IN (CB-name) AT TIME OF 
execution-status 


CB-name _ Identifies the name of the control block from which 
the registers for the current Agent EB were 


obtained: 

SDWA MVS System Diagnostic Workarea 
(Failure). 

TCB MVS Task Control Block (Suspend). 


STSV MVS SRB Status Save Area (Suspend). 


execution-status 
Indicates the current execution status of the Agent 
EB at the time of error: 


Failure Failing execution EB. 
Suspend Suspended execution EB. 


Change of Primary Address Space 


Since all register data references refer to the primary address 
space associated with the currently active execution EB, the fol- 
lowing information is displayed each time the primary address 
changed during execution: 


CHANGE OF ADDRESS SPACE, NEW PASID=pasid 


pasid Indicates the new primary address space identifier 
associated with the save areas that follow. 


~~ Internal DB2 Information ~— “| 
This message is issued by the following CSECT(s): DSNWDFST 


| Ss End of internal DB2 Information _______—_| 


System Action: Save Area Trace format processing continues 
for the failing Agent EB, and all associated Agent EBs. 


System Programmer Response: See the Problem Determi- 
nation section. 


Problem Determination: This report may be used to determine 
the register contents, module invocation sequence,.and exe- 
cution environments leading up to the point of error. 


DSNW061I SAVE AREA TRACE COMPLETE 


Explanation: This message indicates that the DB2 formatted 
Save Area Trace report (DSNWO60I) is complete. 
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| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNWDFST 


Neate ere End of internal DB2 Information ee Te | 


System Action: Dump format processing continues. 


DSNWO062!I  R6 (R6-contents) DOES NOT CONTAIN A VALID EB 


ADDRESS 


Explanation: During dump format processing of the DB2 for- 
matted Save Area Trace report (DSNWO0601), register 6 (R6) did 
not contain the address of a valid Agent execution block (EB). 


R6-contents: The contents of register 6. 


| Internal DB2 Information ~~ Oana oe 
This message is issued by the following CSECT(s): DSNWDFST 


oe End of Internal DB2 information Se 


System Action: Save Area Trace format processing is termi- 
nated for the current Agent EB, and all prior EBs. 


System Programmer Response: The dump formatter expects 
the contents of register 6 to contain the address of a valid EB. 


Problem Determination: Register 6 does not contain the 
current EB address or a prior EB address. 


Refer to the abend reason and completion codes associated 
with the original error to determine the use of register 6 prior to 
the failure. 


DSNWO063! name (address) ASID (asid) NOT FOUND IN DUMP 


Explanation: During dump formatter processing of the Save 
Area Trace report (DSNWO60i), a control block or save area was 
not found in the dump data set. 


Since the dump formatter utilizes the DB2 and MVS control 
blocks defined under the 'name' field of this message to locate 
individual register save areas, subsequent save areas located 
via the 'named' control block or save area will not be dis- 
played in the report. 


name Identifies the name of the control block or save area 
that was not found in the dump data set: 
SA indicates a Save Area 
ASCE DB2 Address Space Control Element 
EB DB2 Execution Block 
TCB MVS Task Control Block 
RB MVS Request Block 
XSB MVS Extended Status Block 
PSA MVS Prefix Save Area 


SDWA MVS System Diagnostic Work Area 
STSV MVS SRB Status Save Area 


STKE MVS.Cross Memory Stack Element 
address The address of the 'named' control block or save 
area. 
asid The address space identifier associated with the 


contro! block or save area. 


a ee : Internal DB2 Information zs 
This message is issued by the following CSECT(s): DSNWDFST 


Pere et, End of Internal DB2 Information eee ee ae 


System Action: Register Save Area Trace format processing 
for the current save area chains is terminated. Subsequent 
save area processing will vary depending on the specific 
control block or save area that was available, and the DB2 
Agent execution environments at the time of the error. 


System Programmer Response: Due to the execution struc- 
tures and environmental! restrictions of selected DB2 and MVS 
control structures, some control blocks and save areas associ- 
ated with these execution environments will not be included in 
the dump data set. 


Problem Determination: During MVS/RTM recovery proc- 
essing, IFC Dump Services attempts to include all control 
blocks (both DB2 and MVS), and the pertinent DB2 save areas 
in the dump data set, regardless of the type of error. Control 
blocks and save areas associated with the following address 
spaces at time of error will be included in the dump data set: 


* Primary, Secondary, and Home address spaces. 


* DB2 System Services and Database Services address 
spaces. 


DSNW1081 UNABLE TO AUTOMATICALLY START type TRACE 


Explanation: System parameters indicated that a DB2 trace 
should be started automatically during DB2 subsystem initial- 
ization, but the DB2 subsystem was unable to start the trace. A 
nonzero return code was received from the -START TRACE 
command. 


——— — Internal DB2 Information ~——_—_—————sS— | 


This message is issued by the following CSECT(s): DSNWVTIT, 
DSNWVZIT 


ego Soe End of Internal DB2 Information eek el 


System Action: Subsystem initialization continues. 


Operator Response: Start the trace via the -START TRACE 
command after DB2 subsystem initialization is complete. 


DSNW1091 TRACE INITIALIZATION PARAMETERS UNAVAIL- 


ABLE, DEFAULTS ASSUMED 


Explanation: The trace function was unable to access the trace 
initialization parameters defined by the DSN6SYSP macro. 
Default values as defined by that macro are assumed for trace 
parameters. 


| Internal DB2 Information ~"——_———<~CSCS~«* 


This message is issued by the following CSECT(s): DSNWVTIT, 
DSNWVZIT 


er End of Internal DB2 Information Pon oe ee 


System Action: Subsystem initialization continues. 


DSNW1081 — DSNW122I 


Operator Response: Determine if the system parameters 
module DSNZPARM is missing or inaccessible. If not, deter- 
mine if the CSECT DSN6SYSP is missing. Trace can be started 
with the -START TRACE command. 


DSNW120! A SPECIFIED keyword VALUE IS INVALID FOR 


type TRACE 


Explanation: A trace command has been entered, but a speci- 
fied keyword value is not valid for the trace type requested. 


| eo —- Internal DB2 information ~ | 
This message is issued by the following CSECT(s): DSNWVCM1 


[Ss End of internal DB2 Information = 


System Action: Processing for the TRACE command is termi- 
nated. 


Operator Response: Ifa —START TRACE command was 
entered, specify a valid destination for the trace. Otherwise, a 
— DISPLAY TRACE command may be issued to determine what 
traces are currently active. Refer to Chapter 2 of Command and 
Utility Reference for details concerning valid destinations. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSNW1211 A SPECIFIED CLASS VALUE IS INVALID FOR type 


TRACE 


Explanation: A trace command has been entered, but a speci- 
fied class value is not valid for the trace type requested. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNWVCM1 


te geeeaeeeees End of Interna! DB2 Information oot neil 


System Action: Processing for the TRACE command is termi- 
nated. 


Operator Response: Ifa —START TRACE command was 
entered, specify a valid class for the trace. Otherwise, a 

— DISPLAY TRACE command may be issued to determine what 
options are currently active. Refer to Chapter 2 of Command 
and Utility Reference for details concerning valid classes. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSNW1221 THE KEYWORD keyword IS NOT VALID FOR type 


TRACE 


Explanation: A trace command has been entered, but 
‘keyword' is not valid for the trace type specified. 


a Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWVCM1 


[ed ee Se End of Internal DB2 Information | 


System Action: Processing for the TRACE command is termi- 
nated. 
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DSNW1231 — DSNW126I 


Operator Response: Either the named keyword must be 
omitted from the command, or a different type of trace must be 
specified. Refer to Chapter 2 of Command and Utility Reference 
for details concerning valid combinations of keywords and trace 
types. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSNW1231 csect-name TRACE RECORDING HAS BEEN 


RESUMED ON dest 


Explanation: '‘dest' destination resumes acceptance of trace 
data after a failure. 


al ~~ Internal DB2 Information == 


This message is originated by the following CSECT(s): 
DSNWVGTF, DSNWVSMF, DSNWVSRV 


ee End of Internal DB2 Information eee 


System Action: Data recording is resumed. 


DSNW124l csect-name type TRACE TERMINATED RC = code 


Explanation: During processing 'type' trace, processing 
abnormally terminated due to an error. A trace type of blank 
indicates all tracing has stopped. 'RMID', displayed in 
decimal, identifies the resource manager. 'RC', displayed in 
hexadecimal, specifies the return/reason/abend code associ- 
ated with the action. 


Further collection of the named trace is stopped. if it is neces- 
sary to resume collection of the trace, a — START TRACE 
command may be issued. However if another failure is experi- 
enced, the problem should be resolved before starting the trace 
collection again. 


fo or ee ~ Internal DB2 Information a | 


This message is originated by the following CSECT(s): 
DSNWVFRR, DSNWVZSS, DSNWVZSA 


eee End of Internal DB2 Information ee ere 


System Action: Processing for the named trace type is 
stopped. The message is not externalized by the functional 
recovery routine, but is outputted whenever a IFC event is 
driven at a later time. A trace type of blank indicates all tracing 
has stopped. 


User Response: Investigate the reasons for the failure. 


Operator Response: If necessary to collect the named trace, 
issue a — START TRACE command to resume processing. 


Problem Determination: Obtain a copy of the system or ter- 
minal log. If a dump was produced, have it printed. Print a copy 
of the contents of the SYS1.LOGREC for the time period 
involved. Forward these items along with a copy of the system 
log to the system programmer. 
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DSNW1251 MULTIPLE ENTRIES NOT ALLOWED FOR keyword 


AND keyword 


Explanation: The following matrix shows keywords which can 
have multiple entries and the valid combinations. If the row 
keyword has multiple values then the column keyword can have 
multiple (M) entries or a maximum of one (1). 


Certain keywords are not allowed with some commands. Refer 
to Chapter 2 of Command and Utility Reference for additional 
information. 


Author- 
ization 
Class Dest Plan iD RMID TNO IFCID- Loca 

Class M M M M M M M 
Dest. M M M M M M M 
Plan M M 1 M 1 M 1 
Authori- M M 1 M 1 M 1 
zation 
ID 
RMID M M M M M M M 
TNO M M 1 1 M M 1 
IFCID M M M M M M M 
Loca M M 1 1 M 1 M 


ae internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNWVCM1 


beet oeans, End of Internal DB2 Information ee 


System Action: Processing for the TRACE command is termi- 
nated. 


Operator Response: Reenter the command omitting the invalid 
keyword. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSNW1261 type TRACE NOT ALLOWED, ACTIVE TRACE 


TABLE FULL 


Explanation: The 'type' trace cannot be started because the 
active trace table is has reached the maximum number of 
active traces allowed. 


pes es Internal DB2 Information aan aie aaa 
This message is issued by the following CSECT(s): DSNWVCM1 


Uae ees eee: End of Internal DB2 Information eee ye a) 


System Action: Processing for the TRACE command is termi- 
nated. 


Operator Response: Use the — DISPLAY TRACE command to 
see if an active trace could be stopped. An active trace must be 
stopped before any other start trace command will be proc- 
essed. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. , 


DSNW1271 CURRENT TRACE ACTIVITY IS — 


Explanation: This message is the title for the — DISPLAY 
TRACE command output. The DSNW128! message is followed 
by one or more DSNW129] messages. Message DSNW138! indi- 
cated that the — DISPLAY TRACE command completed success- 
fully. 


pe ee Internal DB2 Information ——. 
This message is issued by the following CSECT(s): DSNWVCM1 


| End of internal DB2 Information ____——_— 


DSNW1281 TNO TYPE CLASS DEST QUAL 


Expianation: This message is issued before any — DISPLAY 
TRACE responses. The message follows message DSNW1271. 
The title indicates the trace number that is active, the type of 
trace, the class within type, and the destination specified for the 
active trace entries. Whether the trace is qualified is also dis- 
played. If QUAL = YES, the trace is qualified by authorization 
ID, plan, RMID, or location. If QUAL=NO, the trace is not quali- 
fied. Qualification information can be requested by specifying 
DETAIL(2) on — DISPLAY TRACE. Refer to messages 
DSNW143!, DSNW1441, and DSNW145l for more information 
about — DISPLAY TRACE. 


| Internal DB2 Information ~~ ~ I 
This message is issued by the following CSECT(s): DSNWVCM1 


[send of Internal DB2 Information dt 


DSNW129I 


Explanation: This message is issued for — DISPLAY TRACE 
responses. The message indicates the trace number that is 
active, the type of trace, the class within type, and the destina- 
tion specified for the active trace entries. Whether the trace is 
qualified is also displayed. if QUAL=YES, the trace is qualified 
by authorization ID, plan, RMID, or location. If QUAL=NO, the 
trace is not qualified. Qualification information may be 
requested by specifying DETAIL(2) on — DISPLAY TRACE. 
Refer to messages DSNW1431, DSNW144i, and DSNW145l for 
trace qualification information. 


tno type class dest qual 


The message follows message number DSNW128I or DSNW1239I. 
if.more information is available than can be displayed on one 
line, subsequent lines of information are displayed. 


| internal DB2 Information Co | 
This message is issued by the following CSECT(s): DSNWVCM1 


Lo End of Internal DB2 Information eet A) 


DSNW1301 type TRACE STARTED ASSIGNED TRACE 
NUMBER tno 
Explanation: ‘type' trace has been started and assigned the 


decimal trace number 'tno'. Multiple messages are possible 
when the start request specifies multiple plans or multiple 
authorization ids. 


DSNW127I — DSNW1331 


[pe eee Internal DB2 Information a, | 
This message is issued by the following CSECT: DSNWVCM1 


[nen ateeaos, End of internal DB2 Information Leder sett jae 


System Action: Processing for the — START TRACE command 
will continue. 


DSNW1311 STOP TRACE SUCCESSFUL FOR TRACE 


NUMBER(S) tno.... 


Explanation: The trace number(s), 'tno,...', have been 
stopped. Up to five decimal trace numbers may be listed. If 
more than five traces have been stopped, then another 
DSNW 1311 message is sent. 


[eo ore ea Internal DB2 Information aiid 
This message is issued by the following CSECT(s): DSNWVCM1 


Nt oe eee End of Internal DB2 Information coud ne foal 


System Action: Processing for the —STOP TRACE command 
will continue. 


DSNW1321 MODIFY TRACE SUCCESSFUL FOR TRACE 


NUMBER(S) tno.... 


Explanation: The trace numbers, 'tno,...', have been modified. 
Up to five numbers may be listed. If more than five traces have 
been modified, then another DSNW131I message is sent. 


TO internal DB2 Information as, 
This message is issued by the following CSECT(s): DSNWVCM1 


oe End of Internal DB2 Information eee 


System Action: Processing for the modify command will con- 
tinue. 


DSNW1331 csect-name TRACE DATA LOST, dest NOT 


ACCESSIBLE RC =code 


Explanation: The destination specified stopped accepting trace 
data during a trace. Some condition external to DB2 caused the 
data rejection. The reason for failure is defined by the return 
code (RC). The RC hexadecimal value can be: 


* The hexadecimal return code from SMF. Refer to the 
appropriate MVS publication for the specific value. 


¢ The hexadecimal! return code from the GTF request. 
04 GTF trace and/or USR tracing is not active. 
* The hexadecimal return code from the SRV request. 


10 The serviceability routine is absent. 
xx The serviceability routine return code. 
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DSNW1351 — DSNW140I 


(=. ” —————~_ Internal DB2 Information ~~ =i 


This message is issued by the following CSECT(s): 


DSNWVGTF DSNWVSMF DSNWVSRV- 
DSNWVOPX 


ee eo, End of Internal DB2 Information sd 


System Action: Trace processing continues although data will 
be lost. 


This message will also be issued if a -START TRACE command 
is entered from the console or from the DB2i commands panel 
to an unassigned OPn or OPX destination. This is because the 
OP destination is not activated until an application program 
claims the buffer. DB2 will begin writing trace records to the 
buffer when an application program issues a -START TRACE to 
this same OP buffer destination. 


Operator Response: Investigate the GTF or SMF facility to 
determine why data is not being accepted. You may want to 
issue a — START TRACE command to record the data at 
another destination. The — DISPLAY TRACE command shows 
what types of data were recorded at the specified destination. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command. Refer to MVS/XA System Pro- 
gramming Library: Service Aids or MVS/XA System 
Programming Library: System Management Facilities (SMF) or 
System Management Facilities (SMF) manual for an explanation 
of the return code value. 


DSNW135! type TRACE ALREADY ACTIVED, TRACE NUMBER 


tno 


Explanation: 'type' trace was already active with trace 
number ‘tno’. 


| ~ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNWVCM1 


End of Internal DB2 Information re 


System Action: Processing for the ~ START TRACE command 
will continue. 


DSNW1371 SPECIFIED TRACE NOT ACTIVE 


Explanation: The specified trace could not be found in the 
active trace table. 


[~~ — Internal DB2 Information ees Sa gl 
This message is issued by the following CSECT(s): DSNWVCM1 


| send of internal DB2 Information ____—_| 


System Action: Processing for the —STOP or — DISPLAY 
TRACE command will continue. 


Operator Response: You may wish to issue an unqualified 

— DISPLAY TRACE command to determine all the active trace 
entries. If no traces are active then an unqualified — DISPLAY 
TRACE command response message is a DSNW137I message. 
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DSNW1381 = IFCID ifcid-number IS INVALID 


Explanation: The specified IFCID number is outside the range 
of valid IFCID numbers or is an IFCID number which is not 
allowed on a trace command as specified in Section 6 (Volume 
2) of Administration Guide. 


Internal DB2 Information = > | 
This message is issued by the following CSECT(s): DSNWVCM1 


re End of Interna! DB2 Information eee 


System Action: Processing of the trace command is terminated 
before any trace functions are performed. 


User Response: Investigate the reason for the failure. 
Operator Response: Investigate the reason for the problem. 


Problem Determination: Refer to Section 6 (Volume 2) of 
Administration Guide for a list of valid IFCID numbers. 


DSNW1391 AUTHORIZATION FAILURE BECAUSE 


authorization-privilege PRIVILEGE REQUIRED 


Explanation: The user of the command does not have the 
required authorization privilege to execute the command. 


| internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNWVCM1 


{| Ss Ena of Internal DB2 Information 


System Action: Command processing is stopped. 
User Response: Notify the security administrator. 
Operator Response: Notify the security administrator. 


Problem Determination: Obtain a copy of the command input 
and verify the user’s current authorization from the DB2 sub- 
system catalog. 


DSNW1401 ALL OPN DESTINATIONS ARE ASSIGNED 


Explanation: The request could not be processed because 
destinations OP1 - OP8 were assigned. 


a ee Internal DB2 Information —— 
This message is issued by the following CSECT(s): DSNWVCM1 


[eee End of Internal DB2 Information pe Sacre tee S| 


System Action: Processing of the trace command is terminated 
before any trace functions are performed. 


User Response: Investigate the reason for the faiiure. 


Operator Response: Investigate the reason for the problem by 
doing a display trace to analyze the active traces. 


Problem Determination: Analyze why all the OPn destinations 
are active after doing a display trace. 


| 
| 


DSNW141l STORAGE NOT AVAILABLE FOR BUFFER SIZE 


size K BYTES 


Explanation: The request could not be processed because 
storage cannot be obtained for the OPn destination storage 
buffer. 


[ ee ~~ _ Internal DB2 Information == yl 
This message is issued by the following CSECT(s): DSNWVCM2 


(eee End of Internal DB2 Information Seeks 


System Action: Processing of the trace command is termi- 
nated. 


User Response: Investigate the reason for the failure. 


Operator Response: Investigate the reason for the problem by 
doing a display trace to analyze the active traces. 


Problem Determination: The problem is caused either because 
one or more prior start traces to an OPn destination used all 
the storage in the IFC OPn storage pool or because ECSA con- 
tiguous storage was not available. The IFC OPn storage pool 
limit is approximately 4 megabytes. When a trace is stopped the 
buffer storage is not free. If another start trace is issued to the 
same destination, the storage will be reused. If the requested 
storage is greater than the current unassigned buffer, it is free 
and a larger buffer is obtained. If the requested storage is less 
than the current unassigned buffer, the buffer is reused. Frag- 
mentation can occur if either application programs or an oper- 
ator specify numerous start commands for varying size buffers. 


DSNW142i SPECIFIED BUFSIZE IS INCOMPATIBLE WITH 


ASSIGNED BUFFER 


Explanation: The request could not be processed because the 
start trace command specified a BUFSIZE value for an OPn des- 
tination which has a buffer already assigned with a different 
BUFSIZE. 


[ = ~ Internal DB2 Information ~~ ae 
This message is issued by the following CSECT(s): DSNWVCM2 


eer End of Internal DB2 Information Sete 


System Action: Processing of the trace command is termi- 
nated. 


User Response: Investigate the reason for the failure. 


Operator Response: investigate the reason for the problem. 


Problem Determination: The problem may be caused by one 
application program attempting to start a trace to a destination 
owned by another program. This is a site problem and can be 
solved by having application programs start traces to an OPX 
destination rather than a specific OPn destination. If only one 
application program is starting traces, then the program should 
either specify the same BUFSIZE for all requests or should not 
specify BUFSIZE. 


DSNW1431 CURRENT TRACE QUALIFICATIONS ARE - 


Explanation: This message is issued before -DISPLAY TRACE 
responses when DETAIL(2) is specified. 


| 


| 
| 


DSNW1411l — DSNW146I 


| : ~ Internal DB2 information : Sao | 
This message is issued by the following CSECT(s): DSNWVCM1 


[eet stmt End of Internal DB2 Information ie oetaisie nl 


DSNW1441 TNO AUTHID PLAN RMID LOCATION 


Explanation: This message is issued before -DISPLAY TRACE 
responses when DETAIL(2) is specified. The title indicates the 
trace number that is active, the authorization ID, the plan, the 
RMID, and the location specified for the active trace entries. 
The message follows message DSNW143]. The message 
number is not displayed to save space on the message line. 


| Internal DB2 Information se Fa 
This message is issued by the following CSECT(s): DSNWVCM1 


[xopeeeo et e End of Internal DB2 Information eee ne) 


DSNW145!1 tno authid plan rmid location 


Explanation: This message is issued for -DISPLAY TRACE 
responses when DETAIL(2) is specified. The message indicates 
the trace number that is active, the authorization ID, the plan, 
the RMID, and the location specified for the active trace entries. 


The message follows messages DSNW143I or DSNW144I. If 
more information is available than can be displayed on one 
line, subsequent lines of information are displayed. The 
message number is not displayed to save space on the 
message line. 


Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNWVCM1 


eet Sete End of internal DB2 Information el eee 


DSNW1461 MULTIPLE ENTRIES NOT ALLOWED FOR keyword, 


keyword AND keyword 


Explanation: The following matrix shows keywords that can 
have multiple entries and the valid combinations. If the row 
keyword has multiple values, the column keyword can have 
multiple (M) entries or a maximum of one (1). 


Author- 
ization 
Class Dest Plan 1D RMID TNO Loca 

Class M M M M M M 
Dest M M M M M M 
Plan M M 1 M 1 1 
Authori- M M 1 M 1 1 
zation 
1D 
RMID M M M M M M 
TNO M M 1 1 M 1 
Loca M M 1 1 M 1 


Certain keywords are not allowed with some commands. Refer 
to Command and Utility Reference for additional information. 
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System Action: Processing for the TRACE command is termi- 
nated. 


| [= —_ Internal DB2 Information ~~ 
| This message is issued by the following CSECT(s): DSNWVCM1 


Ls End of internal DB2 Information _____| 


Operator Response: Omit the invalid keyword and reenter the 
command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 
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Relational Data System Messages (DSNX...) 


DSNX100!1 = bind-type SQL WARNING USING authorization-id 
AUTHORITY PLAN = plan-id DBRM = dbrm name 
STATEMENT = statement number object name IS 


NOT DEFINED 


Explanation: The indicated object is not defined in the DB2 
catalog. 


bind-type Type of BIND subcommand that caused the warning: 
BIND, REBIND 

authorization-id 
Authorization ID used during the BIND process; for a 
BIND subcommand, indicates the authorization ID of 
the plan owner. For a REBIND subcomman4d, indi- 
cates the authorization ID of the owner specified by 
the subcommand, or the latest owner of the plan. 

plan-id Name of the application plan specified in the BIND 
subcommand, blank if the application plan is not 
specified. 

dbrm name 
Name of the DBRM that contains the reference to the 
indicated object. 

statement number 
Statement number of the SQL statement referencing 
the name of the object. 

object name 
Name of the object that is not defined in the DB2 
catalog. 


System Action: A valid plan is created if no errors are detected 
and VALIDATE(RUN) is in effect. 


System Programmer Response: Ensure that the indicated 
tabie is created before the statement is executed. Otherwise, 
execution of this statement results in an error. 


This statement is bound dynamically on each execution of the 
statement. For better performance, REBIND the application 
program after the indicated object is created. 


DSNX1011 = bind-type SQL WARNING USING authorization-id 
AUTHORITY PLAN = plan-id DBRM = dbrm name 
STATEMENT = statement number THE SPECIFIED 
AUTHORIZATION-ID DOES NOT HAVE THE PRIVI- 
LEGE TO PERFORM OPERATION op name ON 


OBJECT object name 


Explanation: A privilege required for application plan exe- 
cution is not possessed by the indicated authorization ID. 


bind-type Type of BIND subcommand that caused the warning: 
BIND, REBIND 

authorization-id 
Authorization {D used during the bind process. Fora 
BIND subcommand, indicates the authorization ID of 
the plan owner. For a REBIND subcomman4d, indi- 
cates the authorization ID of the owner specified by 
the subcommand, or the latest owner of the plan. 

plan-id Name of the application plan specified in the BIND 
subcommand. Blank if the application plan is not 
specified. 

dbrm name 
Name of the DBRM that contains the unauthorized 
operation. 

statement number 
Statement number of the SQL statement containing 
the unauthorized operation. 


System Action: A valid plan is created if no errors are detected 
and VALIDATE(RUN) is in effect. 


System Programmer Response: Either (1) ensure that the 
appropriate authority is granted to the invoker of the latest 
BIND subcommand against this application plan, or (2) reinvoke 
the BIND subcommand using an authorization ID with authority 
to perform all the operations in this application plan. One of 
these must be done before this statement is executed. Other- 
wise, execution of this statement results in an error. 


This statement is bound dynamically on each execution of the 
statement. For better performance, rebind the application 
program after the appropriate authority is granted to the 
invoker of the BIND subcommand against this application plan. 


DSNX1021 _—bind-type SQL WARNING USING authorization-id 
AUTHORITY PLAN = pian-id DBRM = dbrm name 
STATEMENT = statement number THE REQUIRED 
INDEX HAS NOT BEEN CREATED ON TABLE table 
name IN PARTITIONED TABLESPACE table space 


name 


Explanation: There was an attempt to reference the table in 
the table space (both specified in the message) when the 
required index had not been created. 


bind-type Type of BIND subcommand that caused the warning: 
BIND, REBIND 

authorization-id 
Authorization ID used during the bind process. Fora 
BIND subcomman4d, indicates the authorization ID of 
the plan owner. For a REBIND subcommand, indi- 
cates the authorization |D of the owner specified by 
the subcomman4d, or the latest owner of the plan. 

plan-id Name of the application plan specified in the BIND 
subcommand. Blank if the application plan is not 
specified. 

dbrm name 
Name of the DBRM that contains the reference to the 
indicated table. 

statement number 
Statement number of the SQL statement referencing 
the indicated table. 


System Action: A valid plan is created if no errors are detected 
and VALIDATE(RUN) is in effect. 


System Programmer Response: Ensure that the required index 
on the indicated table in the partitioned table space is created 
before the statement is executed. Otherwise, execution of this 
statement results in an error. This statement is bound dynam- 
ically on each execution of the statement. For better perform- 
ance, rebind the application program after the required index is 
created. 


DSNX103I ~—bind-type SQL WARNING USING authorization-id 
AUTHORITY PLAN = pian-id DBRM = dbrm name 
STATEMENT = statement number BIND ISOLATION 
LEVEL RR CONFLICTS WITH TABLESPACE 


LOCKSIZE PAGE 


Explanation: The specification of isolation level RR is incom- 
patible with the LOCKSIZE PAGE specification for a table space 
accessed by the application plan. Table space locking is used 
in order to protect the integrity of the application. 


DB2 Messages 3-247 


DSNX1041 — DSNX200! 


bind-type Type of BIND subcommand that caused the warning: 
BIND, REBIND 

authorization-id 
Authorization ID used during the bind process. Fora 
BIND subcomman4d, indicates the authorization ID of 
the plan owner. For a REBIND subcommand, indi- 
cates the authorization ID of the owner specified by 
the subcommand, or the latest owner of the plan. 

plan-id Name of the application plan specified in the BIND 
subcommand. Blank if the application plan is not 
specified. 

dbrm name 
Name of the DBRM that contains the reference to the 
indicated table. 

statement number 
Statement number of the SQL statement referencing 
the indicated table. 


System Action: A valid plan is created if no errors are 
detected. Table space locking is used. RR isolation level is 
preserved. 


System Programmer Response: If page locking is desired, 
ISOLATION LEVEL CS must be used. 


DSNX104! _—sibind-type SQL WARNING USING authorization-id 
AUTHORITY PLAN = plan-id DBRM = dbrm name 
STATEMENT = statement number THE RESULT OF 
DECIMAL MULTIPLICATION MAY CAUSE OVER- 


FLOW 


Explanation: An arithmetic expression contains a decimal mul- 
tiplication that may cause an overflow condition when the state- 
ment is executed. The problem may be corrected by 
restructuring the arithmetic expression so that decimal multipli- 
cation precedes decimal division or by changing the precision 
and scale of the operands in the arithmetic expression. Refer 
to Chapter 3 of SQL Reference for the precision and scale of the 
decimal multiplication and division results. 


bind-type Type of BIND subcommand that caused the warning: 
BIND, REBIND 

authorization-id 
Authorization ID used during the bind process. Fora 
BIND subcommand, indicates the authorization ID of 
the plan owner. For a REBIND subcommand, indi- 
cates the authorization ID of the owner specified by 
the subcommand, or the latest owner of the plan. 

plan-id Name of the application plan specified in the BIND 
subcommand. Blank if the application plan is not 
specified. 

dbrm name 
Name of the DBRM that contains the reference to the 
indicated table. 

statement number 
Statement number of the SQL statement referencing 
the indicated table. 


System Action: A valid plan is created if no errors are 
detected. 


DSNX1051 = bind-type SQL WARNING USING authorization-id 
AUTHORITY PLAN = plan-id DBRM = dbrm name 
STATEMENT = statement number SQL CODE = sqi 


code TOKENS = token list 


Explanation: A SQL warning code is generated while proc- 
essing a SQL statement. 


bind-type Type of BIND subcommand that caused the warning: 
BIND, REBIND 
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authorization-id 
Authorization ID used during the bind process. Fora 
BIND subcomman4d, indicates the authorization ID of 
the plan owner. For a REBIND subcomman4d, indi- 
cates the authorization ID of the owner specified by 
the subcommand, or the latest owner of the plan. 

plan-id Name of the application plan specified in the BIND 
subcommand. Blank if the application plan is not 
specified. ; 

sq! code Identifies the particular SQL warning code. The 
value and semantics of the code are the same as the 
SQL return codes documented in “Section 2. SQL 
Return Codes” on page 2-1. 

dbrm name 
Name of the DBRM that contains the error. 

statement number 
Statement number of the SQL statement containing 
the error. 

token list Sequence of one or more tokens separated by 
blanks. Refer to “Section 2. SQL Return Codes” on 
page 2-1 for an explanation of tokens. 


System Action: A valid plan is created if no errors are 
detected. 


System Programmer Response: Refer to “Section 2. SQL 
Return Codes” on page 2-1, for the particular SQL return code 
given in this message. If the reason code is negative, this 
statement is bound dynamically on each execution of the state- 
ment. For better performance, rebind the application program 
after correcting this statement or after the required object is 
created or altered. 


DSNX200! _—bind-type SQL ERROR USING authorization-id 
AUTHORITY PLAN = plan-id DBRM = dbrm name 
STATEMENT = statement number SQL CODE = sql 
code TOKENS = token list CSECT NAME = csect 


name RDS CODE = rds code 


Explanation: An error has been detected while processing a 
SQL statement. 


bind-type Type of BIND subcommand that caused the error: 
BIND, REBIND 

authorization-id 
Authorization ID used during the bind process. Fora 
BIND subcommand, indicates the authorization ID of 
the plan owner. For a REBIND subcommand, indi- 
cates the authorization ID of the owner specified by 
the subcommand, or the latest owner of the plan. 

pian-id Name of the application plan specified in the BIND 
subcommand. Blank if the application plan is not 
specified. 

sql code Identifies the particular SQL error detected. The 
value and semantics of the code are the same as the 
SQL return codes documented in “Section 2. SQL 
Return Codes” on page 2-1. 

dbrm name 
Name of the DBRM that contains the error. 

statement-number 
Statement number containing SQL error. 

token list Optional sequence of one or more tokens separated 
by blanks. These are the tokens that are to be sub- 
stituted into the text of the error code as described 
at the beginning of “Section 2. SQL Return Codes” 
on page 2-1. 

csect name 
Name of the CSECT that detected the error. 

rds code Unique code of the RDS subcomponent. 


System Action: No application plan is created. 


System Programmer Response: Correct the SQL errors in the 
application program associated with the indicated DBRM. Pre- 
compile the application program, and reinvoke the BIND sub- 
command. 


DSNX201I _—bind-type DBRM ERROR USING authorization-id 
AUTHORITY PLAN = pian-id DBRM dbrm name IS 


IN AN INCONSISTENT STATE 


Explanation: The content of a DBRM has been modified after 
the precompilation process. 


bind-type Type of BIND subcommand that caused the warning: 
BIND, REBIND 
authorization-id 
Authorization ID of the plan owner. 
Name of the application plan specified in the BIND or 
REBIND subcommand (or blank if the application 
plan is not specified). 
dbrm name 
Name of the DBRM that is in error. 


plan-id 


System Action: No application plan is created. 


System Programmer Response: Precompile the application 
program associated with the indicated DBRM. Reinvoke the 
BIND subcommand. 


DSNX2021 INVALID AMODE ATTRIBUTE FOUND FOR DATE 
OR TIME INSTALLATION REPLACEABLE EXIT 


ROUTINE module-name 


Explanation: During DB2 startup, the Relational Data System 
subcomponent loads the Date (DSNXVDTX) and Time 
(DSNXVTMxX) exit routines. In the MVS/XA environment these 
routines must have the link-edited attributes AMODE(31) and 
RMODE(ANY). The module listed in the message 
*module-name' did not have the correct addressing attributes. 
if the date and time LOCAL installation option is specified, DB2 
will be unable to execute the date and time functions required 
by the exit routine that failed to load. 


[ fre ge ea Internal DB2 Information nae. | 
This message is issued by the following CSECT(s): DSNXINIT 


[Lo End of Internal DB2 Information PRET | 


System Action: The load module is deleted. DB2 startup will 
continue. 


Operator Response: Notify the system programmer. 


System Programmer Response: When DB2 is stopped, the date 
and time exit routine must be link-edited again with the correct 

AMODE and RMODE control statements. For more information, 
refer to Appendixes of Administration Guide. 


DSNX203! LOAD OF THE DATE OR TIME INSTALLATION 
REPLACEABLE EXIT ROUTINE module-name 
FAILED WITH MVS ABEND CODE = abend-code 
REASON CODE = reason-code DB2 STARTUP 


WILL CONTINUE 


Explanation: During DB2 startup, the Relational Data System 
subcomponent loads the date (DSNXVDTX) and time 
(DSNXVTMxX) exit routines. During the load of EXIT ROUTINE 
‘module-name', MVS issued the abend code and reason code 
that would cause abnormal termination of the task, but the 
abend was suppressed. If the date and time LOCAL option is 
specified, DB2 will be unable to execute the date and time func- 
tions required by the exit routine that failed to load. 


DSNX2011 — DSNX2031 


[ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNXINIT 


—— End of Internal DB2 Information eee 


System Action: The load failed. DB2 startup will continue. 
Operator Response: Notify the system programmer. 


System Programmer Response: When DB2 is stopped, the date 
and time exit routine must be link-edited correctly. For more 
information, refer to Appendixes of Administration Guide. 
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Initialization Procedures Messages (DSNY...) 


DSNY001i SUBSYSTEM STARTING 


Explanation: The -START DB2 command is accepted. This 
message is issued to the MVS console that issued the -START 
command. The DSNS022I message is sent when the DB2 sub- 
system startup process has completed. Refer to the DSN90221 
message for additional information. 


i —— Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNYSTRT 


eee te End of Internal DB2 Information a eee 


System Action: DB2 startup processing begins. 


DSNY0021 SUBSYSTEM STOPPING 


Explanation: The -STOP DB2 command is accepted. The 
DSN9022! message is issued when the DB2 subsystem shut- 
down process has completed. The message is issued either to 
the crigin of the -STOP DB2 command (for MVS MCS console) 
or to the MVS console from which the -START DB2 command 
was received. Refer to the DSN90221 message for additional 
information. 


=~ = ~ Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSNYSCMD 


{oo End of Internal DB2 Information Oe 


System Action: DB2 subsystem shutdown is initiated. 


DSNY003I SUBSYSTEM IS ALREADY ACTIVE 


Explanation: The -START DB2 command has not been 
accepted, because the DB2 subsystem is active. The DSN9023I 
message is issued after this message. Refer to the DSN9023I 
message for additional information. 


| Internal DB2 Information : ae } 
This message is issued by the following CSECT(s): DSNYSCMD 


Ramet as, End of Internal DB2 Information eee eee 


DSNY0041 SUBSYSTEM IS ALREADY STOPPING 


Explanation: The -STOP DB2 command has not been accepted 
either because the DB2 subsystem shutdown is in progress for 
the specified option (QUIESCE or FORCE), or because the 
QUIESCE option was specified after a FORCE option had been 
previously accepted. The DSN9023! message is issued after 
this message. Refer to the DSN9023i message for additional 
information. 


a Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNYSCMD 


lee te End of Internal DB2 Information eet 


System Action: DB2 subsystem shutdown is continued. 


DSNY00Si SUBSYSTEM STARTUP TERMINATED, INVALID 


START COMMAND 


Explanation: The DB2 subsystem can be started only by a 
-START DB2 command. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNYSTRT 


| End of Internal DB2 Information 


System Action: DB2 subsystem startup is terminated. 


Operator Response: Start the DB2 subsystem via the -START 
DB2 command, and reenter the rejected command. 


DSNYO0O6I csect-name INVALID AMODE OR RMODE ATTRI- 


BUTE FOUND FOR LOAD MODULE module name 


Explanation: The Initialization Procedures subcomponent 
detected that a module had an invalid AMODE or RMODE attri- 
bute when it was loaded. In the error message, 'module 
name’ is the name of the load module with an invalid 
addressing or residency mode. 


a ~~ Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): DSNYASCP, 
DSNYASTR, DSNYSTRT, DSNYSIRM 


eee End of Internal DB2 Information Site et il 


System Action: DB2 subsystem startup is terminated. 


Operator Response: Notify the system programmer of the 
failure. 


System Programmer Response: Verify that all installation and 
maintenance activities against DB2 were executed using SMP, 
that the JCLIN for SMP includes the correct AMODE and 
RMODE contro! statements, and that the Linkage Editor pro- 
vided with the Data Facility Product (DFP) was invoked by SMP 
for the link edits. Correct the procedure or JCL that caused the 
error and rerun the necessary SMP jobs. 


Problem Determination: A DB2 dump was requested to an MVS 
SYS1.DUMP data set. The MVS service aid AMBLIST provides 
Linkage Editor module attributes in the summary section of the 
LISTLOAD function output. 


DSNY0071 LOAD MODULE DSNHDECP DOES NOT HAVE 


RMODE(24) ATTRIBUTE 


Explanation: The named load module was not link-edited with 
the required RMODE(24) attribute. 
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eee Internal DB2 information | 
This message is issued by the following CSECT(s): DSNYASCP 


Desay ss ene End of Internal DB2 Information eee 


System Action: DB2 startup is abnormally terminated with 
reason code 00E80160. 


Operator Response: Notify the system programmer. 
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System Programmer Response: Verify that all installation and 
maintenance activities against DSNHDECP were executed using 
SMP. JCLIN for SMP must have included the correct AMODE 
and RMODE control statements. The Linkage Editor, provided 
with the Data Facility Product (DFP), was invoked by SMP for 
the link-edits. Correct the procedure or JCL that caused the 
error and rerun the necessary SMP jobs. 


Problem Determination: The MVS service aid AMBLIST pro- 
vides Linkage Editor module attributes in the summary section 
of the LISTLOAD function output. 


DSNZ002!1 — DSNZO002!I 





System Parameter Manager System (DSNZ...) 


DSNZ002I src SUBSYS ssnm SYSTEM PARAMETERS LOAD 


MODULE NAME IS dsnzparm-name 


Explanation: DB2 subsystem 'ssnm' is being started with the 
‘dsnzparm-name' DSNZPARM load module. This message is 
written to the MVS console which entered the -START DB2 
command. The message will also appear in the JES SYSLOG 
and on the JES JOB LOG of ssnmMSTR. The message contains 
the name of the DSNZPARM load module entered by the oper- 
ator or the default name (DSNZPARM) if no name was entered. 


[- ~ ‘Internal DB2 Information ~~ 7a eee 
This message is issued by the following CSECT(s): DSNZINIT 


(a End of Internal DB2 Information ee eee 


System Action: DB2 startup processing continues. 
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Service Facility Messages (DSN1...) 


The messages in this section apply to DSNiLOGP, 
DSN1COPY and DSN1PRNT, which are part of the 
service facility subcomponent of DB2. 


Service Facility Message 
Severity Codes 


The value shown for 'severity' in the service 
facility messages that follow is the value returned 
as the job-step condition code from the job-step 
during which the message is issued. If additional 
messages having higher severity values are 
issued during the same job-step, the higher value 
is reflected as the job-step condition code. 


Severity values have the following meanings: 


0 An informational message. No error has 
occurred. 

4 A warning message. A condition has been 
detected of which the user should be aware. 
The user may need to take further action. 

8 An error message. An error situation has 
been detected and processing could not con- 
tinue. 

12 A severe error message. A severe error situ- 
ation has been detected and processing 
could not continue. 


DSN1110E LIMIT OF 50 STATEMENTS EXCEEDED 


Explanation: DSN1LOGP allows a total of 50 statements for a 
given job. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job using no more than 50 state- 
menis. 


DSN1111E LIMIT OF 80 TOKENS EXCEEDED 


Explanation: DSN1LOGP allows a total of 80 keywords and cor- 
responding value specifications. A keyword with its value is 
considered two tokens. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job using no more than 80 
keywords. 


DSN1112E TOKEN xx..xx EXCEEDS 64 HEXADECIMAL CHAR- 
ACTERS 


Explanation: The SYSIN input contains the character string 
'xx..xx'. This string is invalid. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job with the specified token 
being no more than 64 hexadecimal characters in length. 


DSN1113E VALUE FOR KEYWORD xxxxxxxx INVALID 


Explanation: The SYSIN input contains the keyword 
"Xxxxxxxx'. The value specified for that keyword is not of the 
form ‘( value )'. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job with the correct form of the 
keyword. The problem might be that the closing parenthesis 
')' is missing or that an extra blank exists in the value. 


DSN1114E RBASTART MULTIPLY DEFINED 


Explanation: The RBASTART parameter can be specified only 
once for a given job. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job using a single RBASTART 
value. 


DSN1115E RBASTART > 12 HEX CHARACTERS 


Explanation: The maximum size of a log RBA in DB2 is 6 bytes 
(hence, 12 characters). 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a valid RBASTART 
value of no more than 12 hexadecimal characters. 


DSN1116E RBAEND MULTIPLY DEFINED 


Explanation: The RBAEND parameter can be specified only 
once for a given job. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a single RBAEND 
parameter. 
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DSN1117E RBAEND SPECIFIED WITH NO VALUE 


Explanation: The RBAEND keyword specifies the last valid 
hexadecimal log RBA that is to be extracted. RBAEND must be 
followed by a value. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing an associated 
value for the RBAEND parameter. 


DSN1118E RBAEND > 12 HEX CHARACTERS 


Explanation: The maximum size of a log RBA in DB2 is 6 bytes 
(hence, 12 characters). 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing an RBAEND value 
that is no more than 12 hexadecimal characters. 


DSN1119E DBID MULTIPLY DEFINED 


Explanation: The DBID keyword can be specified only once for 
a given job. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a single DBID 
value. 


DSN1120E DBID SPECIFIED WITH NO VALUE 


Explanation: The DBID keyword specifies a hexadecimal data- 
base identifier and must be followed by a value. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a DBID (value). 


DSN1121E DBID > 4 HEX CHARACTERS 


Explanation: A DBID is 2 bytes in length (hence, 4 characters 
maximum). 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a DBID which is no 
longer than 4 hexadecimal characters. 


DSN1122E OBID MULTIPLY DEFINED 


Explanation: The OBID keyword can be specified only once for 
a given job. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a single OBID 
value. 


3-256 DB2 Messages and Codes 


DSN1123E OBID SPECIFIED WITH NO VALUE 


Explanation: The OBID keyword specifies a hexadecimal data- 
base object identifier. OBID must be followed by a value. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing an OBID (value). 


DSN1124E OBID > 4 HEX CHARACTERS 


Explanation: An OBID is 2 bytes in length (hence, 4 characters 
maximum). 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing an OBID which is 
no longer than 4 hexadecimal characters. 


DSN1125E PAGE SPECIFIED WITH NO VALUE 


Explanation: The PAGE keyword specifies a hexadecimal page 
number. PAGE must be followed by a value. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a PAGE (value). 


DSN1126E 


Explanation: A page number is 3 bytes in length (hence, 6 
characters maximum). 


PAGE > 6 HEX CHARACTERS 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a PAGE value 
which is no longer than 6 hexadecimal characters. 


DSN1127E KEYWORD xxxxxxxx UNKNOWN 


Explanation: DSN1LOGP does not recognize the keyword 
"XXXXXXXX '. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Check to make sure all keywords are valid 
and resubmit the job. 


DSN1128E RBAEND WITHOUT RBASTART 


Explanation: You cannot specify the end of a search range 
(RBAEND) without specifying a beginning of the search range 
(RBASTART). 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing an RBASTART 
(value) to correspond to the RBAEND (value) given to specify a 
valid search range. 


DSN1129E PAGE WITHOUT DBID OBID 


Explanation: DB2 pages exist in objects called 'page sets'. 
When you specify a page, you must also identify the page set by 
using the appropriate DBID and OBID specifications. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing the associated 
DBID (value) and OBID (value) that correspond to the given 
page. 


DSN1130E OBID WITHOUT DBID 


Explanation: When you specify an OBID, you must also identify 
the database that contains that OBID by specifying the DBID of 
the database. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing both an OBID 
(value) and a DBID (value). 


DSN1131E OFFSET/VALUE PAIR NUMBER xx CONTAINS 


INVALID HEX DATA 


Explanation: A hexadecimal specification is required. The 
value for offset/value pair number 'xx' contains an invalid 
hexadecimal! character. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a correct 
hexadecimal value specification. 


DSN1132E URID SPECIFIED WITH NO VALUE 


Explanation: The URID keyword specifies the hexadecimal unit 
of recovery identifier. URID must be followed by a value. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing an associated 
value for the URID parameter. 


DSN1133E URID > 12 HEX CHARACTERS 


Explanation: The maximum size of a URID in DB2 is 6 bytes 
(hence, 12 characters). 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a valid URID value 
of no more than 12 hexadecimal characters. 


DSN1134E —_ LIMIT OF 10 URIDS EXCEEDED 


Explanation: A maximum of 10 URID keywords can be speci- 
fied in any given job. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing no more than 10 
URID keywords. 


DSN1129E — DSN1140E 


DSN1135E SUMMARY MULTIPLY DEFINED 

Explanation: The SUMMARY option can be specified only once. 
Severity: 8 (error) 

System Action: Processing is terminated. 


User Response: Resubmit the job using a singe SUMMARY 
specification. 


DSN1136E SUMMARY SPECIFIED WITH NO VALUE OR 


INCORRECT VALUE 


Explanation: The permitted values for summary are 'YES', 
'NO', or ‘ONLY’. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a valid parameter 
for the SUMMARY option. 


DSN11371 FIRST PAGESET CONTROL RECORD AFTER 


RESTART = nannnnnnnonn 


Explanation: nnnnnnnnnnnn is the log RBA of a record that 
serves as an implicit indication that a restart occurred just prior 
to this point. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1138E PAGE AND IRD CANNOT BOTH BE SPECIFIED. 


Explanation: The RID keyword specifies a 4-byte hexadecimal 
number, with the first 3 bytes representing the page number 
and the fast byte representing the record ID. You cannot 
specify both a PAGE value and a RID value. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job specifying either a PAGE 
value or a RID value. 


DSN1139E RID SPECIFIED WITH NO VALUE 


Explanation: The RID keyword specifies a 4-byte hexadecimal 
number, with the first 3 bytes representing the page number 
and the last byte representing the record ID. A value must be 
associated with the RID. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a RID (value). 


DSN1140E RID > 8 HEX CHARACTERS 


Explanation: The maximum size of a RID in DB2 is 4 bytes 
(hence, 8 characters). 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing a valid RID value 
of no more than 8 hexadecimal characters. 
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DSN1141E — DSN1151I 


DSN1141E RID WITHOUT DBID OBID 


Explanation: The DBID and OBID associated with the given RID 
value must be specified. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing the associated 
DBID (value) and OBID (value) that correspond to the given RID 
value. 


DSN1142E DATAONLY MULTIPLY DEFINED 


Explanation: The DATAONLY option limits the log records 
extracted in the detail report to those that represent data mod- 
ifications. This option can be specified only once. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job specifying DATAONLY once. 


DSN1143E DATAONLY SPECIFIED WITH NO VALUE OR 


INCORRECT VALUE 


Explanation: The DATAONLY keyword must be specified with 
either a YES or NO value. Any other value (including no vaiue) 
is incorrect. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job specifying the correct value 
for the DATAONLY parameter. 


DSN1144E RBASTART SPECIFIED WITH NO VALUE 


Explanation: The RBASTART keyword specifies the 
hexadecimal log RBA from which to begin extraction. 
RBASTART must be followed by a value. 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job providing an associated 
value for the RBASTART parameter. 


DSN1145E Current RESTART timestamp 


TIMESTAMP = YY.DDD HH.MM.SS LOG 

RBA = xxxxxx is out of sequence. The greatest 
timestamp seen so far is TIMESTAMP = YY.DDD 
HH.MM.SS LOG RBA = xxxxxx. Multiple 
processors may be writing to the same log. 


Explanation: This message indicates that the current log 
record has a timestamp that is less than the greatest timestamp 
processed so far. This may be a potential problem. 


[~ ois ~ Internal DB2 Information ~~ ant 
This message is issued by the following CSECT(s): DSN1LOUT 


ate End of internal DB2 Information eee 


Severity: 4 (warning) 
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System Action: Processing continues. 


User Response: Examine current log to determine whether 
multiple processors are writing to the same log. (Data may be 
being overwritten.) This may lead to data inconsistencies. 


DSN1146E Current END CHECKPOINT timestamp 
TIMESTAMP =YY.DDD HH.MM.SS LOG 

RBA = xxxxxx is out of sequence. The greatest 
timestamp seen so far is TIMESTAMP = YY.DDD 
HH.MM.SS LOG RBA = xxxxxx. Multiple 


processors may be writing to the same log. 


Explanation: This message indicates that the current log 
record has a timestamp that is less than the previous 
timestamp processed. This may be a potential problem. 


co. Internal DB2 Information EI 
This message is issued by the following CSECT(s): DSN1LOUT 


[ites ee eee End of Internal DB2 Information fe caren 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Examine current log to determine whether 
multiple processors are writing to the same log. (Data may be 
being overwritten.) This may lead to data inconsistencies. 


DSN11501 SUMMARY OF COMPLETED EVENTS 


Explanation: This message heads the summary of completed 
units of recovery (URs) and checkpoints. For a description of 

this section of the summary report, refer to Section 3 of Diag- 

nosis Guide and Reference. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN11511 UR CONNID =cc CORRID = bb AUTHID=aa 
PLAN = pp START DATE = yy ddd TIME = hh:mm:ss 


DISP = .xx INFO =ii START = ss END = ee 


Explanation: This message describes a unit of recovery that 
terminated. 


© cc = the connection id (for example, BATCH) 
* bb = the correlation id (for example, JOB xxx) 
* aa = the authorization id executing the UR 

* pp = the plan name used by the UR 


Note: DSN1LOGP will return a plan name of SYSTEM in 
this field if the UR was generated as a result of a system 
event (such as the first update of a table space, for 
example). In such a case, no bound plan exists for the UR 
described. 

© yy.ddd=the starting date of the UR 

¢ hh:mm:ss =the starting time of the UR 

¢ xx = the disposition of the UR. Options include: 
— Inflight 
— In-abort 
— In-commit 
— Indoubt 
— Committed 
— Aborted 


Note: In the event the UR was bypassed by a conditional 
restart, the Log Extractor will indicate this by preceding the 
disposition value with the word ‘BYPASSED’. 

e ji = the status of the data. Either: 

- COMPLETE, indicating that all page sets modified by 
this UR have been identified. 

— PARTIAL, indicating that the list of page sets modified 
by this UR is incomplete. The Log Extractor will indi- 
cate PARTIAL status if all records associated with a UR 
are not available, and no checkpoint is found prior to 
the UR’s completion. 

* ss = the log RBA of the first log record associated with the 

UR (that is, the URID) 

* ee = the log RBA of the last log record associated with the 

UR 


This message is followed by messages that identify the page 
sets modified by the UR. For each page set, a single message 
of the following form is printed. 


DATABASE = dbid = dbname 
PAGESET = obid = psname 


Where: 


¢ dbid = the internal database identifier 
¢ dbname = the database name corresponding to the dbid 
¢ obid = the internal page set identifier 
® psname = the page set name corresponding to the obid 


Note: The 'dbname' and 'psname' fields may be absent if 
a full checkpoint was unavailable to the Log Extractor or 
was caused by overlapped processing of DB2 during a 
checkpoint. 


If no data was modified by the UR (as is the case for certain 
URs created merely to track information that is valid only for the 
life of the application), the phrase NO DATA MODIFIED is 
printed. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1152I UR CONNID =** CORRID = ** AUTHID = ** 
PLAN =** START DATE = ** TIME = ** DISP = xx 


INFO = ii START =ss END =ee 


Explanation: This message describes a unit of recovery. The 
UR identifying information (**) described in message DSN1151! 
is unavailable. The remaining information (DISP, INFO, START, 
and END) appears just as it does in message DSN1151I. If the 
UR did not complete, however, the END value wil! not be 
printed. 


This message, too, is followed by messages that identify the 
page sets modified by the UR; details of that may be found in 
the preceding discussion of message DSN11511. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN11531 CHECKPOINT START =ss END =ee DATE = yy.ddd 


TIME = hh:mm:ss 


Expianation: This message describes a complete checkpoint 
on the jog starting at RBA 'ss' and ending at RBA ‘ee’. If the 
information is available, DSN1LOGP will also return the date 
and time that the checkpoint was completed. 


When this message follows message DSN1157I RESTART 
SUMMARY, it identifies the checkpoint that would be used at 
restart. If no checkpoint is available, message DSN1158I will be 
printed instead. 


DSN11521 — DSN1158I 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN11541 RESTART AT xx DATE = yy.ddd TIME = hh:mm:ss 


Explanation: A normal restart occurred at log RBA 'xx'. 
DSN1LOGP also returns the date and time of that restart. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1155! CONDITIONAL RESTART AT xx DATE = yy.ddd 
TIME = hh:mm:ss STARTRBA = ss ENDRBA = ee 


FORWARD = ff BACKOUT = bb 


Explanation: A conditional restart occurred at the log RBA 
*xx'. DSNILOGP also returns the date and time of that restart. 


¢ ss = the relative byte address of the beginning of the 
restart 

¢ ee = the relative byte address of the conclusion of the 
restart 

¢ ff = whether forward log recovery phase was to be 
bypassed (YES | NO) 

© bb = whether backward log recovery phase was to be 
bypassed (YES | NO) 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN11561 ALL URS COMPLETE 
Explanation: There are no URs outstanding for restart. 
Severity: 0 (informational) 


System Action: Processing continues. 


DSN11571 RESTART SUMMARY 


Explanation: This message heads the summary of the 
description of work to be performed at restart. Restart informa- 
tion that follows is based on the scope of the log scanned. For 
a description of this section of the summary report, refer to 
Section 3 of Diagnosis Guide and Reference. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1158l NO CHECKPOINT AVAILABLE — RESTART 


SUMMARY INCOMPLETE 


Explanation: No checkpoint is available within the scope of the 
log scanned. The information following this message includes: 


e URs that have not completed 
¢ Page sets modified by these URs 
¢ Page sets with writes pending. 


The information cannot be considered complete. 
Severity: 0 (informational) 


System Action: Processing continues. 
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DSN1159! — DSN1172E 


DSN1159! NO DATABASE WRITES PENDING 


Explanation: All database I/O has been completed. If the Log 
Extractor can find no complete checkpoint, it will return an addi- 
tional message ‘(BASED ON INCOMPLETE LOG 

INFORMATION) ', to warn you that there may in fact be pending 
database writes. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN11601 


Explanation: Database writes are pending at restart. Each 
page set with outstanding I/O is identified by a separate 
message following this one: 


DATABASE = dbid = dbname 
PAGESET = obid = psname START =ss 


Where: 


DATABASE WRITES PENDING: 


* dbid = the internal database identifier 
¢ dbname = the database name corresponding to the dbid 
* obid = the internal page set identifier 
* psname = the page set name corresponding to the obid 


Note: dbname and psname may be absent if a full check- 
point was unavailable to the Log Extractor or was caused 
by overlapped processing of DB2 during a checkpoint. 

* ss = the log RBA of the earliest log record required to 
complete outstanding writes for this page set. If the value 
of ss is returned as **, this information is unavailable. Such 
will be the case if the Log Extractor is unable to locate a full 
checkpoint. In this event, DSN1LOGP will return an addi- 
tional message (LIST MAY BE INCOMPLETE), to alert you to 
the possibility that the list of page sets with outstanding 
writes may be incomplete. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN11621I UR CONNID = cc CORRID = bb AUTHID=aa 
PLAN = pp START DATE = yy.ddd TIME = hh:mm:ss 


DISP = xx INFO = ii START =ss 


Explanation: This message describes a unit of recovery that 
has 'not' terminated. The information returned is the same as 
that for message DSN1153I, except that, because the UR did not 
terminate in this case, no END field is required here. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1163E NO CHECKPOINT AVAILABLE DUE TO LOG 


ERROR -- RESTART SUMMARY INCOMPLETE 


Explanation: A log error was encountered. DSNILOGP 
marked any checkpoints encountered before the log error as 
invalid. There were no complete checkpoints following the log 
error in the specified log range. The information following this 
message includes: 


* URs that have not completed 
¢ Page set modified by these URs 
¢ Page sets with writes pending. 


This information cannot be considered complete. 
Severity: 0 (informational) 


System Action: Processing continues. 
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DSN1164E INVALID xxxx FOUND AT RBA = yyyyyyyyyyyy 


Explanation: While processing the SUMMARY option, an 
invalid checkpoint record (either URE or RURE identified by 
'xxxx') was encountered in the log. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILSUM 


Neeser ores End of Internal DB2 Information ese e ss) 


Severity: 0 (informational) 
System Action: Processing continues. 


User Response: If the checkpoint record identified in the 
message is used to restart DB2, the restart will fail because 
DB2 will not be able to process the unit of recovery presented 
by the invalid URE or RURE. DB2 must be restarted from a pre- 
vious checkpoint to correctly process all units of recovery. The 
Print Log Map utility can be used to list the checkpoint records 
in the BSDS, and the CHKPTRBA parameter of the Change Log 
inventory utility can be used to direct the DB2 restart to use a 
particular checkpoint. For more information on the Print Log 
Map and Change Log Inventory utilities, refer to Section 3 of 
Diagnosis Guide and Reference. 


DSN1170E SUBTYPE MULTIPLY DEFINED 


Explanation: The SUBTYPE parameter can be specified only 
once for any given job. 


: Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILPAR 


ay arene End of Internal DB2 Information ee eg a) 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a single SUBTYPE value and resubmit 
the job. 


DSN1171E SUBTYPE SPECIFIED WITH NO VALUE 


Explanation: The SUBTYPE parameter specifies a decimal set 
subtype. The SUBTYPE must be followed by a value, i.e. 
SUBTYPE(value). 


| Internal DB2 Information os “| 
This message is issued by the following CSECT(s): DSN1ILPAR 


ae End of Internal DB2 Information Tee | 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a SUBTYPE value and resubmit the 
job. 


DSN1172E SUBTYPE > 2 DECIMAL CHARACTERS 


Explanation: The maximum size of a SUBTYPE is 2 decimal 
characters. 


. Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILPAR 


ees End of Internal DB2 Information eee ere 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a SUBTYPE value with a maximum of 
2 decimal characters and resubmit the job. 


DSN1173E INVALID SUBTYPE GIVEN - SEE COMMAND & 


UTILITY REFERENCE FOR A LIST OF VALID SUB- 
TYPES 


Explanation: The given SUBTYPE is not a valid subtype. 


[ MP eee Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNiLPAR 


este End of interna! DB2 Information ee et 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Refer to Chapter 3 of Command and Utility 
Reference for a list of valid subtypes. Provide a valid SUBTYPE 
and resubmit the job. 


DSN1174E OFFSET SPECIFIED WITH NO SUBTYPE 


Explanation: The given OFFSET has no corresponding 
SUBTYPE. 


a Tae Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILPAR 


(ea Rea es End of Internal DB2 Information ee 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a valid SUBTYPE for the given 
OFFSET and resubmit the job. 


DSN1175E OFFSET SPECIFIED WITH NO VALUE OR INCOR- 


RECT VALUE 


Explanation: The given OFFSET has no corresponding VALUE 
given or an incorrect VALUE is specified, such as specifying 
another keyword in place of a value. 


[ : Internal DB2 Information ~~ | 
This message is issued by the following CSECT(s): DSNILPAR 


eer End of Internal DB2 Information te feel 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a valid VALUE for the given OFFSET 
and resubmit the job. 


DSN1173E — DSN1179E 


DSN1176E OFFSET > 8 HEX CHARACTERS 


Explanation: The maximum size for an OFFSET is 4 bytes 
(hence, 8 characters). 


= ee Internal DB2 Information <=. e 
This message is issued by the following CSECT(s): DSNILPAR 


re End of internal DB2 Information papi el 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide an OFFSET with a maximum of 8 char- 
acters and resubmit the job. 


DSN1177E _—LIMIT OF 10 OFFSET, VALUE PAIRS EXCEEDED 


Explanation: A maximum of 10 OFFSET, VALUE pairs can be 
specified for a given log record SUBTYPE. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1ILPAR 


De ore, End of Internal DB2 Information ee 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a maximum of 10 OFFSET, VALUE 
pairs for a given SUBTYPE and resubmit the job. 


DSN1178E OFFSET SPECIFIED WITH NO CORRESPONDING 


VALUE 


Explanation: The given OFFSET has no corresponding VALUE 
keyword specified. 


| Interna! DB2 Information ~~ Se 
This message is issued by the following CSECT(s): DSNILPAR 


[te ees End of Internal DB2 Information eee ge | 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide an associated VALUE (value) for the 
given OFFSET and resubmit the job. 


DSN1179E VALUE SPECIFIED WITH NO CORRESPONDING 
OFFSET OR SUBTYPE PARAMETER 


Explanation: The given VALUE has either no corresponding 
OFFSET or SUBTYPE parameter specified. 


[ . ~ Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILPAR 


[eet eee End of Internal DB2 Information ei oo Ill 


Severity: 12 (severe error) 


DB2 Messages 3-261 


DSN1180E — DSN1216E 


System Action: Processing terminates. 


User Response: Provide an associated OFFSET or SUBTYPE 
for the given VALUE and resubmit the job. 


DSN1180E VALUE SPECIFIED WITH NO VALUE OR INCOR- 


RECT VALUE 


Explanation: The given VALUE has no corresponding value 
given, an incorrect value is specified, such as specifying a 
keyword in place of a value, or an uneven number of characters 
were specified. 


| —— Internal DB2 Information oy 
This message is issued by the following CSECT(s): DSNILPAR 


es End of internal DB2 Information eee Bi 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a valid value for the given VALUE and 
resubmit the job. 


DSN1181E VALUE SPECIFIED WITH NO CORRESPONDING 


OFFSET 


Explanation: The given VALUE has no corresponding OFFSET 
specified. 


i * ~~~ internal DB2 Information =e | 
This message is issued by the following CSECT(s): DSNILPAR 


Sa End of Internal DB2 Information ee 


Severity: 12 (severe error) 
System Action: Processing terminates. 


User Response: Provide a valid OFFSET for the given VALUE 
and resubmit the job. 


DSN1210E DSNJSLR ERROR RETCODE = xxxxxxxx REASON 


CODE ~yyyyyyyy 


Explanation: The stand-alone log read function detected an 
error. The return code (RETCODE) and reason code included in 
the message are explained in Section 3 of Diagnosis Guide and 
Reference. 


Severity: 8 (error) 


System Action: Processing is terminated. 


DSN1211E DSNJSLR RETURNED BAD LOG RBA 
Explanation: One of the three problems listed below exists. 


1. The recovery log data set is damaged. 
2. You identified a data set that isn’t a recovery log data set. 
3. The stand-alone log read service has a problem. 


Severity: 0 (informational) 
System Action: Processing continues. 


User Response: Determine if the problem is your error by 
dumping the data set and determining if it is a log data set. 
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Problem Determination: A common error is to specify the first 
data set on an archive tape (the 'Bxxxxxxx' data set) as a log 
data set; it is actually a BSDS. 


DSN12121 FIRST LOG RBA ENCOUNTERED XxxxxxxXxXxxxXx 


Explanation: This identifies the RBA of the first log record 
read. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN12131 LAST LOG RBA ENCOUNTERED xxxxxxxxXxxxx 


Explanation: This identifies the RBA of the last log record 
read. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1214I NUMBER OF LOG RECORDS PROCESSED 


nnnnnnannnannnnnann 


Explanation: This identifies the number (in decimal) of 
‘logical’ log records read during DSN1LOGP processing. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN12151 NO LOG RECORDS WERE READ 


Explanation: DSN1LOGP read no log records. 
Severity: 0 (informational) 
System Action: Processing continues. Possible explanations: 


¢ An error prevents DSNILOGP from continuing, so no log 
records have yet been processed. If this is the case, an 
error message should precede this message. 

¢ You specified the active log data sets or archive log data 
sets out of RBA sequence. 

¢ You specified a STARTRBA that is greater than any RBA in 
the active and/or archive data sets available. 


DSN1216E DSNJSLR ERROR RETCODE = xxxxxxxx REASON 


CODE = yyyyyyyy RBA=nnnnnnnnnannn 


Explanation: The stand-alone ‘jog read function returned an 
error indicating that either the log has an error in one of the 
control intervals (Cl) or a data set containing requested RBA 
cannot be located. The RBA specification in the message indi- 
cates where the error was detected and gives the requested 
RBA. It will point: 


¢ To the start of the Cl if there is a problem with the log 
control interval definition (LCID), or with any of the general 
control information within a Cl. 

¢ To the log record in the Cl if there is a problem with a log 
record header (LRH). 


If this is the first log record read during this execution of the 
Log Extractor, and if there is a problem with the LCID, the RBA 
specification will be all zeros. 


Before returning any records, the Log Extractor checks the 
control information (LCID) at the end of a Ci, and analyzes the 
LRH to ensure that all records are properly chained together 
within the Cl. If an error is detected while performing this 
process, DSNILOGP will issue this message, before dumping 
the entire Cl. It will not format individual records within the Cl, 
but will, if possible, continue processing by reading the next Cl. 


Severity: 0 (informational) 


System Action: Processing continues. 


Problem Determination: The REASON CODE identifies the 
nature of the error. Refer to Section 3 of Diagnosis Guide and 
Reference for the values and meanings for this code, and for 
the return code (RETCODE). 


DSN1217E DSNJSLR WARNING RETCODE = xxxxxxxx 
REASON CODE = yyyyyyyy PRIOR 
RBA=nonnnnannnnnn CURRENT 


RBA = nnnnnannnannn 


Explanation: A gap in the log RBA range has been encount- 
ered. The PRIOR RBA specification indicates the last good log 
RBA prior to the gap. The CURRENT RBA specification indi- 
cates the log record following the gap, and will be formatted fol- 
lowing this message. 


Severity: 0 (informational) 
System Action: Processing continues. 


Problem Determination: The REASON CODE identifies the 
nature of the error. Refer to Section 3 of Diagnosis Guide and 
Reference for the values and meanings for this code, and for 
the return code (RETCODE). 


DSN1218t NUMBER OF LOG ERROR MESSAGES 


nnnannnannnnannnn 
Explanation: DSN1LOGP distinguishes three classes of errors: 


1. Code problems existing in the DB2 or system code used for 
DSNILOGP. In the event of a SYSABEND dump, a user 
abend code of U0153 will be issued, and DSN1LOGP will be 
terminated. 

2. Incorrect invocation of DSN1LOGP caused, perhaps, by 
your having used an incorrect keyword or missed a DD 
statement. Under these circumstances, DSN1LOGP will 
issue appropriate error messages, and the program will be 
terminated. 

3. Failure by a given log Cl under the scrutiny of DSNILOGP. 
Such scrutiny is performed before any of the records within 
the Cl are processed. Failure is an indication of logical 
damage, and error messages are issued by the Log 
Extractor. The Cl or failing log record is printed, and 
DSN1LOGP continues to the next Cl or log record. 


The count 'nnnnnnnnnannnnnnn' provided summarizes the 
number (in decimal) of errors DSN1LOGP detected while 
accessing the log. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1219E SYSSUMRY DD STATEMENT MISSING 


Explanation: You requested the SUMMARY option, but failed to 
include the SYSSUMRY DD statement in your JCL invocation. 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Resubmit the job with a SYSSUMRY DD state- 
ment included in the JCL invocation. 


DSN1217E — DSN1700E 


DSN1220E ARCHIVE LOG TRUNCATED AT xxxxxxxx - 


INVALID LOG RECORDS WERE READ 


Expianation: At a restart of DB2, an archive log was truncated. 
This archive log data set could not be physically altered to 
reflect this truncation, and invalid log records therefore still 
exist. DSN1LOGP has already reported this information in the 
summary report, and cannot retract it. Nor can it disregard the 
invalid log information already read in order adequately to 
summarize what has occurred. Therefore, all information up to 
this point in the log will be summarized, and a new summary 
report initiated. Consequently, the same UR may be reported 
twice with different dispositions and different page sets modi- 
fied. To avoid this condition, use the BSDS DD statement 
instead of the ARCHIVE DD statement. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1221E DSNJSLR ERROR RETCODE = xxxxxxxx REASON 
CODE = yyyyyyyy VSAM RETURN CODE = aaaa 


ERROR CODE = bbbb 


Explanation: The stand-alone log read function resulted in a 
VSAM error. The DSNJSLR return code (xxxxxxxx), and reason 
code (yyyyyyyy), included in the message are documented in 
Section 3 of Diagnosis Guide and Reference. 


The VSAM return code (aaaa), and error code (bbbb), identify 
the nature of the VSAM error. Refer to the appropriate VSAM 
publication for an explanation of these codes. 


Severity: 0 (informational) 


System Action: Processing continues. 





DSN1222E DSNJSLR ERROR RETCODE = xxxxxxxx REASON 
CODE = yyyyyyyy DYNAMIC ALLOCATION INFOR- 


MATION CODE = aaaa ERROR CODE = bbbb 


Explanation: An error occurred while dynamically allocating a 
log data set. DSNJSLR return code 'xxxxxxxx', and reason 
code 'yyyyyyyy', included in the message, are documented in 
Section 3 of Diagnosis Guide and Reference. information code 
‘aaaa' and error code 'bbbb' were returned by the dynamic 
allocation SVC and identify the nature of the error. Refer to the 
appropriate MVS publication for an explanation of these codes. 


Severity: 12 (severe error) 


System Action: Processing terminates. 


DSN1223E DSNJSLR ERROR RETCODE = xxxxxxxx REASON 


CODE =yyyyyyyy RDJFCB RETURN CODE = aaaa 


Explanation: An error occurred while trying to read the job file 
control block. The DSNJSLR return code (xxxxxxxx), and 
reason code (yyyyyyyy), included in the message are docu- 
mented in Section 3 of Diagnosis Guide and Reference. 


The RDJFCB return code (aaaa), identifies the nature of the 
error. Refer to the appropriate MVS publication for an expiana- . 
tion of these codes. 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1700E VALUE FOR KEYWORD xxxxxxxx IS INVALID 


Explanation: The SDMPIN input contains the 'xxxxxxxx'. The 
value specified for that keyword is invalid. 
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DSN1701E — DSN1707E 


‘7 Internal DB2 Information j | 
This message is issued by the following CSECT(s): DSN1SDMP 


Le eer End of Internal DB2 Information pe ote ie 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide a correct keyword value and resubmit 
the job. 


DSN1701E START TRACE MISSING 


Explanation: The START TRACE command is required. The 
first keyword record of the SDMPIN input does not contain a 
START TRACE command. 


[ : ; Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1SDMP 


ae End of internal DB2 Information | 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Resubmit the job with START TRACE as the 
first keyword record in the SDMPIN input. 


DSN1702E KEYWORD xxxxxxxx MULTIPLY DEFINED 


Explanation: Keyword 'xxxxxxxx' was specified multiple times 
in the SDMPIN input. All keywords are allowed only once. 


= ~~ _ Internal DB2 Information ~~ SH 
This message is issued by the following CSECT(s): DSN1SDMP 


ge End of Internal DB2 Information eee 8a 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Specify the keyword only once. Resubmit the 
job. 


DSN1703E KEYWORD xxxxxxxx UNKNOWN 


Explanation: DSN1SDMP does not recognize the keyword 
"XXXXXXXX'. 


I as, Internal DB2 Information ~ ; 
This message is issued by the following CSECT(s): DSNiSDMP 


a End of Interna! DB2 Information eS ee 


Severity: 8 (error) 


System Action: Processing is terminated. 
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User Response: Make sure that all keywords are valid and 
then resubmit the job. 


DSN1704E UNABLE TO OBTAIN RETURN-AREA STORAGE 


Explanation: An error resulted when DSN1SDMP attempted to 
obtain storage for an instrumentation facility interface (IF1) 
return area. 


a internal DB2 Information aaa | 
This message is issued by the following CSECT(s): DSN1ISDMP 


ee End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: Processing is terminated. 
User Response: When you resubmit the job either: 


* Specify a larger region size in the job control language. 
¢ Reduce the vaiue of BUFSIZE on START TRACE. 


DSN1705E SYNTAX ERROR, LINE = Il, COLUMN = cc 


Explanation: A syntax error was encountered in the SDMPIN 
input. The location of the error is given by: 


ut The line number within the input stream that is in error. 
cc The column number. 


| Internal DB2 Information ee oP a = 
This message is issued by the following CSECT(s): DSN1SDMP 


————— End of Interna! DB2 Information be 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Correct the syntax error and then resubmit 
the error. 


DSN1706E INVALID ABEND CODE SPECIFIED 


Explanation: An invalid abend code was specified on the 
ACTION keyword. 


aa Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1SDMP 


otic: * End of Internal DB2 Information a ea 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Allowabie abend codes are 00E60100 through 
00E60199. Specify an allowable abend code and then resubmit 
the job. 


DSN1707E = LIMIT OF 50 STATEMENTS EXCEEDED 


Explanation: DSN1SDMP allows a maximum of 50 statements 
for a given job. 


Internal DB2 Information =.= 
This message is issued by the following CSECT(s): DSN1SDMP 


err End of Internal DB2 Information | 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Use no more than 50 statements when you 
resubmit the job. 


DSN1708E TOO MANY SELECT CRITERIA VALUES 


Explanation: DSN1SDMP allows a maximum of eight SELECT 
criteria values. 


je Internal DB2 Information See ay 
This message is issued by the following CSECT(s): DSN1ISDMP 


Pita ees End of internal DB2 Information aes | 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Use no more than eight SELECT criteria 
values and then resubmit the job. 


DSN1709E INPUT/OUTPUT ERROR, DDNAME = xxxxxxxx 


Explanation: An error resulted when DSN1SDMP attempted to 
do /O. The ddname of the data set to which I/O failed is 
"XXXXXXXX ! 


[- Interna! DB2 Information SS == 
This message is issued by the following CSECT(s): DSNiSDMP 


| End of Internal DB2 Information 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Ensure that the 'xxxxxxxx' DD statement in 
the job control language is valid and resubmit the job. 


DSN1710E UNABLE TO OPEN SDMPTRAC 


Explanation: An error resulted when DSN1SDMP attempted to 
open the SDMPTRAC data set. 


Internal DB2 Information 7 I 
This message is issued by the following CSECT(s): DSN1iSDMP 


| send of Internal DB2 Information ____—_— 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Ensure that the SDMPTRAC DD statement in 
the job control language is valid and resubmit the job. 


DSN1708E — DSN1713! 


DSN1711E START TRACE ERROR, REASON = xxxxxxxx 


Explanation: DB2 did not process the submitted START TRACE 
command. The reason code 'xxxxxxxx' is returned from the 
instrumentation facility interface (IF!). 


| Internal DB2 Information a i 
This message is issued by the following CSECT(s): DSN1SDMP 


[es wp ee ont End of Internal DB2 Information is Pree hel 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Check the return area that follows message 
DSN17121. Possible problems are: 


¢ The syntax of the START TRACE command is invalid. 
Correct the command and resubmit the job. Do not include 
the subsystem recognition character before the command 
text. 


¢ The user does not have authority to issue trace commands. 
Obtain trace authority and resubmit the job. 


DSN17121 START TRACE RETURN-AREA FOLLOWS: 


Explanation: DSN1SDMP issued the START TRACE command 
and the return area resulting from the instrumentation facility 
interface (IF!) COMMAND call follows this message. The return 
area contains DB2 command response messages. 


eo. internal DB2 Information =i. al 
This message is issued by the following CSECT(s): DSN1SDMP 


|___ End of interna! DB2 Information —___] 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN17131 


Explanation: An error resulted when DSN1SDMP issued a 
instrumentation facility interface (IFi) READA call in an attempt 
to obtain DB2 trace records. Reason code 'xxxxxxxx' is the IFI 
reason code returned in IFCARC2. 


READA ERROR, REASON = xxxxxxxx 


[pos ee, Internal DB2 Information eee 
This message is issued by the following CSECT(s): DSN1SDMP 


Pa op es End of Internal DB2 Information _ 


Severity: 0 (informational) 


System Action: DSN1SDMP writes any records that were 
returned and processing continues. 


User Response: Possible reason codes are: 


00E60802 The DSN1SDMP return area was not large enough to 
hold the returned trace records. This condition 
should not occur because the DSN1SDMP return 
area is the same size as the requested OPn monitor 
‘buffer. 
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DSN1714i — DSN1720I 


0O0E60803 No trace data was available when the READA 
request was made. This condition occurs when the 
trace started by DSN1SDMP is stopped from the 
operator console or by another application program. 


DSN1714l TRACE RECORDS WERE LOST 


Explanation: DB2 trace records were lost and are not con- 
tained in the SDMPTRAC data set. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNISDMP 


ee oe End of Internal DB2 Information eee 


Severity: 0 (informational) 
System Action: Processing continues. 
User Response: Possible reasons for lost trace records are: 


¢ The OP buffer is not large enough. Specify a larger 
BUFSIZE on the START TRACE command and then resubmit 
the job. 


¢ The trace data is too voluminous and buffer is overflowing 
before the data can be read. Specify a more granular 
selectivity on the START TRACE command and then 
resubmit the job. 


DSN1715E UNABLE TO OBTAIN WORK SPACE 


Explanation: An error resulted when DSN1SDMP attempted to 
obtain work area storage. 


7 internal DB2 Information a in| 
This message is issued by the following CSECT(s): DSN1SDMP 


—_———eer End of internal DB2 Information Ae ee 


Severity: _ 8 (error) 
System Action: Processing is terminated. 


User Response: Specify a larger region size in the job control 
language and then resubmit the job. 


DSN1716E UNABLE TO OPEN SDMPIN 


Explanation: An error resulted when DSN1SDMP attempted to 
open the SDMPIN data set. 


| Internal DB2 information | 
This message is issued by the following CSECT(s): DSN1SDMP 


Vetere a ee oe End of Internal DB2 Information peach ore atl 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Ensure that the SDMPIN DD statement in the 
job control language is valid and resubmit the job. 
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DSN17171 STOP TRACE RETURN-AREA FOLLOWS: 


Explanation: DSN1SDMP issued the STOP TRACE command 
and the return area resulting from the instrumentation facility 
interface (IFI) COMMAND call follows this message. The return 
area contains DB2 command response messages. 


fr = Internal DB2 Information “a foe. A 
This message is issued by the following CSECT(s): DSN1SDMP 


es End of Internal DB2 Information _ 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1718E STOP TRACE ERROR, REASON = xxxxxxxx 


Explanation: DSN1SDMP attempted to submit a DB2 STOP 

TRACE command at the end of its processing; however, the 
command failed. The reason code returned from the instru- 
mentation facility interface (IFI) is 'xxxxxxxx'. 


| Internal DB2 Information ” re - 
This message is issued by the following CSECT(s): DSN1ISDMP 


fo A End of Internal DB2 Information es 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Check the return area that follows message 
DSN1717i. One possible problem is: 


¢ The trace has already been stopped from the operator’s 
console or by another application program. 


DSN17191 ACTIONS ARE COMPLETE 


Explanation: All requested IFC selective dump actions fin- 
ished. All trace records have been written to the specified 
destination(s). If an abend action was requested, ail abends 
have taken place. 


o-oo Internal DB2 Information anes 
This message is issued by the following CSECT(s): DSN1ISDMP 


eee End of Internal DB2 Information Seto 


Severity: 0 (informational) 


System Action: DSN1SDMP stops the trace that it started and 
completes processing. 


DSN17201I READA ERROR, REASON = xxxxxxxx 


Explanation: An error resulted when DSN1SDMP issued a 
instrumentation facility interface (IF!} READA call in an attempt 
to obtain DB2 trace records. Reason code 'xxxxxxxx' is the IFi 
reason code returned in IFCARC2. 


[- Sa Eps Internal DB2 Information 
This message is issued by the following CSECT(s): DSN1SDMP 


ee End of Internal DB2 Information amen fetes aie 


Severity: 8 (error) 
System Action: Processing is terminated. 
User Response: One possible reason code is: 


00E60824 The user does not have correct monitor authority. 
Obtain the correct monitor authority (MONITOR1 or 
MONITOR2) and resubmit the job. 


DSN18001 START OF DSN1CHKR FOR JOB job-name step- 


Explanation: This message indicates that DSNICHKR has 
started processing. 


(pes Internal DB2 Information ada 
This message is issued by the following CSECT(s): DSNICHKR 


Ne eee End of Internal DB2 Information | 


Severity: 0 (informational) 


System Action: DSN1CHKR starts processing. 


DSN18011 ANCHOR POINT 'mm' IN ERROR IN PAGE 


‘nnnannn' 


Explanation: This message indicates that the backward pointer 
in anchor point 'mm' is in error in page 'nnnnnn'. Either the 
backward pointer is not zero when the forward pointer is zero, 
or the backward pointer does not point to the last record id in 
the parent chain. 


Interna! DB2 Information | 
This message is issued by the following CSECT(s): DSNICHKR 


ane es End of internal DB2 Information ee | 


Severity: 4 (warning) 


System Action: The page is marked for output if the 
FORMAT/DUMP option is in effect. Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


DSN1802i RING/LINK CHAIN BROKEN - 'type' RID = 


'‘nnannnnnn' 


Explanation: This message indicates that there is a broken 
ring or link chain beginning at 'type' (anchor or parent) with 
record id equal to 'nnnnnnnn'. This is one of a series of mes- 
sages associated with a broken ring or link. It will appear in 
combination with DSN18031, DSN1804I, and DSN18051. 


DSN1800!1 — DSN18051 


| Le Internal DB2 Information — =~ 
This message is issued by the following CSECT(s): DSNILNKF 


ee End of Internal DB2 Information eee 


Severity: 4 (warning) 


System Action: The page is marked for output if the 
FORMAT/DUMP option is in effect. Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


DSN18031 PARENT RID = nnannnnnn 


Explanation: This message supplies the record id 'nnnnnnnn' 
for the parent record of a detected broken ring or link. This is 
one of a series of messages associated with a broken ring or 
link. It will appear in combination with DSN1802!1, DSN18041, and 
DSN1805I. 


Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILNKF 


ees End of Internal DB2 Information Got Moe esl 


Severity: 4 (warning) 
System Action: Processing continues. 


Problem Determination: Contact your !BM Support Center for 
assistance. 


DSN1804! CURRENT RID = 'nnnnnnnn' 


Explanation: This message supplies the record id 'nnnnnnnn' 
for the current record at the time the broken ring or link was 
detected. This is one of a series of messages associated with a 
broken ring or link. It will appear in combination with DSN1802I, 
DSN18031, and DSN180851. 


[ ” Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1ILNKF 


ae en End of Internal DB2 Information (hee ee 


Severity: 4 (warning) 
System Action: Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


DSN18051 PREVIOUS IN CHAIN = ‘nannnnnn' 


Explanation: This message supplies the record id ‘nnnnannnn' 
of the record prior to when the broken ring or link was detected. 
This is one of a series of messages associated with a broken 
ring or link. It will appear in combination with DSN1802I, 
DSN1803!, and DSN18041. 
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DSN1806! — DSN18111 


— — Internal DB2 Information ~ ee | 
This message is issued by the following CSECT(s): DSNILNKF 


(a eee eee End of Interna! DB2 Information eee | 


Severity: 4 (warning) 
System Action: Processing continues. 


Problem Determination: Contact Your IBM Support Center for 
assistance. 


DSN1806I IDMAP ENTRY entry-number IN PAGE page- 


number IS IN ERROR 


Explanation: This message indicates that the IDMAP entry 
‘entry-number' in page 'page-number' is not valid. Valid 
entries are from X'0014' to X'OFhh' (depending on the number 
of IDMAP entries in the page). 


| Internal DB2 Information = ain 


This message is issued by the following CSECT(s): DSNILNKF, 
DSN1MAP 


fies ee Ge End of Internal DB2 Information eae 


Severity: 4 (warning) 


System Action: The page is marked for output if the 
FORMAT/DUMP option is in effect. Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


DSN18071 = =CHILD POINTER 'chd-rid' IN ERROR IN PARENT 


RECORD par-rid IN PAGE pppppp 


Explanation: This message indicates that the parent record 
with record id 'par-rid' in page 'pppppp' has a child pointer 
with an invalid record id of 'chd-rid'. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILNKF 


[bene ae: End of Internal DB2 Information _ 


' Severity: 4 (warning) 


System Action: The page is marked for output if the 
FORMAT/DUMP option is in effect. Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


OVERFLOW RECORD IN ERROR - OVERFLOW RID 


DSN1808! ' 
= 'ovi-rid', POINTER RID = 'ptr-rid' 


Explanation: This message indicates that the record at record 
id 'ovf-rid', pointed to by the pointer record at record id 
‘ptr-rid', is not an overflow record. 
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‘DSN18091 


Internal DB2 Information Whe ae Fae | 


This message is issued by the following CSECT(s): DSNILNKF, 
DSN1MAP 


fet eee End of Interna! DB2 Information Ria heh = ull 


Severity: 4 (warning) 


System Action: The page is marked for output if the 
FORMAT/DUMP option is in effect. Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


OVERFLOW RECORD IN ERROR - OVERFLOW RID 
= 'ovf-rid', HAS NO POINTER RECORD 


Explanation: This message indicates no pointer record points 
to the overflow record with record id '‘ovf-rid’. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNILNKF 


_ re End of Internal DB2 Information tee 


Severity: 4 (warning) 


System Action: The page is marked for output if the 
FORMAT/DUMP option is in effect. Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


DSN1810f INPUT DATA SET INVALID, NOT A CHECKABLE 


SYSTEM TABLESPACE 


Explanation: This message indicates that the data set defined 
by SYSUT1 is not a checkable table space and therefore cannot 
be analyzed. 


[ Internal DB2 information | 
This message is issued by the following CSECT(s): DSNICHKR 


area End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: Processing terminates. 


System Programmer Response: Correct the SYSUT1 DD card 
and rerun the job. 


Problem Determination: Refer to Section 6 of Diagnosis Guide 
and Reference to determine which system table spaces can be 
analyzed. Checkable system table spaces must be referenced 

by a hashed entry or contain links. Single-record table spaces 

referenced by an index are not checkable. 


DSN18111 ANCHOR POINT PAGE page IS OUT OF RANGE — 


VALUE IS LESS THAN 2 OR GREATER THAN 'E'X 


Explanation: The ANCHOR function has an incorrect page 
value for the page-slot argument. Anchor points can be found 
only on pages 2 through 14 (E in hexadecimal). Any anchor 
point page specified beyond that range is invalid. 


ee Internal DB2 Information a 
This message is issued by the following CSECT(s): DSNiMAP 


eee End of Internal DB2 Information eee | 


Severity: 4 (warning) 


System Action: Processing continues with the next set of 
parameters. 


DSN1812I ORPHAN ID = orph-id ID ENTRY = entry-val 


FOUND IN PAGE page-number 


Explanation: This message indicates that the record with id = 
‘orph-id' and id entry = ‘entry-val' in page '‘page-number' is 
an orphan. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSN1IBUFM 


{ Ss End of Internal DB2 Information ____———_—i 


Severity: 4 (warning) 
System Action: Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


DSN18131 UNABLE TO DUMP PAGE page-number 


Explanation: An error was encountered while retrieving the 
page and therefore page 'page-number' could not be dumped. 


| a ae internal DB2 Information ~ a = 
This message is issued by the following CSECT(s): DSNiIBUFM 


fat ee: End of Interna! DB2 Information re 


Severity: 4 (warning) 
System Action: Processing continues. 


Problem Determination: Examine previous diagnostic and 
system messages, correct problem, and rerun job. 


DSN18141 UNEXPECTED END OF DATA AT PAGE page- 


number 


Explanation: The END-OF-DATA condition was reached before 
expected at page 'page-number'. 


[ I be Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1IBUFM 


rn ree End of Internal DB2 Information ee | 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Examine previous diagnostic and 
system messages, correct problem and rerun job. 


DSN18121 — DSN18171 


DSN18151 DSN1ICHKR COMPLETED SUCCESSFULLY, 


"pg-cnt' PAGES PROCESSED 


Explanation: This message indicates the DSN1CGHKR has suc- 
cessfully completed processing; all checks completed. The 
‘pg-cnt' represents the number of pages read during check 
processing, not the number of pages in the tabie space. 


a ee internal DB2 Information 
This message is issued by the following CSECT(s): DSNICHKR 


er End of Internal DB2 Information een aa | 


Severity: 0 (informational) 


System Action: Processing terminates. 


DSN18161 DSN1ICHKR TERMINATED WITH ERRORS, 'pg-cnt' 


PAGES PROCESSED 


Explanation: This message indicates the DSN1CHKR did not 
successfully complete processing. The 'pg-cnt' represents the 
number of pages read during check processing, not the number 
of pages in the table space. 


| ” Internal DB2 Information 
This message is issued by the following CSECT(s): DSNICHKR 


be Peete End of Internal DB2 Information foie cence 


Severity: 4 (warning) or 8 (error) 
System Action: Processing terminates. 


Problem Determination: Examine previous diagnostic mes- 
sages, correct problems if possible and rerun job. Otherwise 
contact your IBM Support Center for assistance. 


DSN1817! ARGUMENT '‘arg-val' OF THE MAP COMMAND IS 


INVALID 


Explanation: This message indicates that the argument 
‘arg-val' of the MAP command is invalid. 


leo internal DB2 Information ~~ | 
This message is issued by the following CSECT(s}): DSNICHKR 


ae cena ee End of internal DB2 Information ead 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Refer tio Chapter 1 of Command and 
Utility Reference for the correct syntax. 


Examples of invalid arguments are: 


© The offset value of the ANCHOR or HASH option is neither 
zero (0) nor four (4). 


¢ When the ANCHOR and RID option has been specified, the 
page number specified is less than two (2), which would be 
a non-data page. 
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DSN1818! IDMAP ENTRY entry-number IN PAGE page- 


number IS BEING USED BY MULTIPLE CHAINS - 
ONE OF WHICH IS IN ERROR 


Explanation: This message indicates that a record is part of 
two different chains and therefore creates an invalid structure 
within the table space. If using the MAP option, the mapping of 
the chain stops since the path back to the starting record is lost. 


re Internal DB2 Information ~—_—————————™ | 


This message is issued by the following CSECT(s): DSNILNKF, 
DSN1MAP 


[ieee ee ee End of internal DB2 Information Papeete 


Severity: 4 (warning) 
System Action: Processing continues. 


Problem Determination: Contact your IBM Support Center for 
assistance. 


DSN18191 HASH VALUE FOR dbid CORRESPONDS TO: 


PAGE = page-number AND ANCHOR POINT 
OFFSET = offset 


Explanation: This message indicates the hash values for the 
given ‘dbid', after applying the hash function, where 
‘page-number' is the page and 'offset' is the anchor point. 


[ ~~ Internal DB2 Information SS ee SI 
This message is issued by the following CSECT(s): DSN1CHKR 


| End of internal DB2 Information ____——__— 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1820! 


Explanation: This message indicates that mapping of the indi- 
cated option 'map-opt', which is either ANCHOR, HASH, PAGE 
or RID, has started. The option’s arguments, 'val1' and '‘val2' 
will also be mapped. Following this message will be the 
records of the chain. 


MAPPING OF 'map-opt' (val1,val2) HAS STARTED 


i —— Internal DB2 Information 
This message is issued by the following CSECT(s): DSNIMAP 


| End of Internal DB2 Information ___———_| 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN18211 MAPPING OF 'map-opt' (val1,val2) HAS COM- 


PLETED 


Explanation: This message indicates that mapping of the indi- © 
cated option 'map-opt', which is either ANCHOR, HASH, PAGE, 
or RID, has started. The option’s arguments, 'val1' and 'val2', 
will also be mapped. Preceding this message will be the 
records of the chain. 
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| — _ Internal DB2 Information rs “er Fl 
This message is issued by the following CSECT(s): DSNIMAP 


ee Festi End of Internal DB2 Information _ 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1822! DBID 'dbid' HASHED TO AN EMPTY ANCHOR 


POINT - NO ENTRIES FOR THE GIVEN DBID ARE 
AVAILABLE IN THE TABLESPACE 


Explanation: DBID 'dbid' hashed to an empty anchor point. 
An anchor point with a value of 0 (empty) means that no entries 
are available in the table space. Therefore, no links are 
checked. 


| Internal DB2 Information a 
This message is issued by the following CSECT(s): DSN1MAP 


Ue eee End of Internal DB2 Information ee ted 


Severity: 4 (warning) 


System Action: Processing continues with the next set of 
parameters. 


DSN1823i INVALID SYNTAX, 'c' EXPECTED 


Explanation: This message indicates that an unexpected char- 
acter was found while parsing the parmlist and that 'c’ was the 
expected character. 


| — Internal DB2 Information ~~ aan 
This message is issued by the following CSECT(s): DSNIMVAL 


ences End of Internal DB2 Information ee 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Refer to Chapter 1 of Command and 
Utility Reference for the correct syntax. 


DSN1824! INVALID HEX DATA: hex-data 


Explanation: This message indicates that the input value 
‘hex-data' is not a valid hexadecimal number. 


i. Internal DB2 Information i a | 
This message is issued by the following CSECT(s): DSNIMVAL 


ere End of Internal DB2 Information ele ate AY 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Correct input value and rerun job. 


DSN18251 INPUT VALUE EITHER TOO LONG OR OMITTED: 


in-val 


Explanation: This message indicates that the input value 
‘in-val' is either greater than 8 hexadecimal digits or was 
totally omitted. 


{ ———~_ Internal DB2 Information pe rae ag >t | 
This message is issued by the following CSECT(s): DSNIMVAL 


{| End of Internal DB2 information __——_| 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Correct input value and rerun job. 


DSN18261 RECORD WITH OBID = '‘rec-obid' IS INVALID 


FOR THIS CHAIN 


Explanation: This message indicates that the record with OBID 
‘rec-obid' is invalid for the chain currently being processed, 
assuming the OBID of the parent or first record processed was 
not in error. 


a ~ Internal DB2 Information ~—s. | 


This message is issued by the following CSECT(s): DSNILNKF, 
DSN1iMAP 


[excite End of Internal DB2 Information | 


Severity: 4 (warning) 
System Action: Processing terminates. 


Problem Determination: !f using the MAP function, make sure 
the given values point to a valid record. Otherwise, contact your 
IBM Support Center for assistance. 


DSN18271 THE SPECIFIED PAGE IS NOT A HASHED DATA 
PAGE - THE REQUESTED FUNCTION REQUIRES A 


HASHED DATA PAGE. 


Explanation: This message indicates that the HASH or 
ANCHOR option of the MAP command was issued against a 
non-hashed data page (that is, a page with no anchor points). 


[eee oe Internal DB2 Information oe ae esi 
This message is issued by the following CSECT(s): DSNIMAP 


a End of Internal DB2 Information eet | 


Severity: 4 (warning) 


System Action: Processing continues with the next set of 
parameters. 


Problem Determination: If using the ANCHOR function, 
examine the page-siot argument to ensure that the page value 
is correct. If using the HASH function, ensure that the 'dbid' 
value is correct. Otherwise, examine the SYSUT1 DD card to 


DSN1825!1 — DSN18301 


ensure that the table space is correct. If so, use the RID or 
PAGE function to achieve the desired mapping. 


DSN1828I OBID = 'rec-obid' IS INVALID FOR THIS DATA- 


BASE 


Explanation: This message indicates that the record with OBID 
‘rec-obid' is invalid for the database currently being proc- 
essed. 


” Internal DB2 Information ] 


This message is issued by the following CSECT(s): DSN1MAP, 
DSN1ILNKF 


{| End of Internal DB2 Information 


Severity: 4 (warning) 


System Action: Processing continues with the next set of 
parameters. 


Problem Determination: Refer to Section 6 of Diagnosis Guide 
and Reference for a list of system databases and their corre- 
sponding OBIDs. Or, if using the MAP command, insure that all 
user supplied offsets actually point to valid data. 


DSN18291 MAPPING MUST STOP AT PARENT RECORD 


WHEN USING THE BACKWARD POINTER 


Explanation: This message indicates that the requested 
mapping has stopped at the parent record rather than the 
starting record because of the use of backward pointers. 


~~~ _ Internal DB2 information ee, 4 
This message is issued by the following CSECT(s): DSN1IMAP 


ee End of internal DB2 Information ree 


Severity: 4 (warning) 


System Action: Processing continues. 


DSN1830i INVALID NUMBERS OF VALUES SPECIFIED FOR 


‘func-name' 
Explanation: This message indicates that either: 
¢ No value was specified. 


e An odd number of values was specified for a function that 
requires an even number of values. 


| Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSNICHKR 


Wetotag e a End of Internal DB2 Information Meee! 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Refer to Chapter 2 of Command and 
Utility Reference for the parameter specifications. Correct the 
parmlist and rerun the job. 
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DSN1831! END OF DATE REACHED, PAGE = page-number 


IS OUT OF RANGE 


Explanation: This message indicates that page 'page-no', 
specified as a parameter of the MAP option, caused the 
END-OF-DATA condition to be reached. The page number is 
invalid for the table space being mapped. 


| Internal DB2 Information = | 
This message is issued by the following CSECT(s): DSN1IMAP 


as End of Internal DB2 Information Foe 


Severity: 4 (warning) 


System Action: Processing continues with the next set of 
parameters. 


Problem Determination: Correct the page parameter of the 
MAP option and rerun the job. 


DSN1833! ANCHOR POINT IS NOT IN USE 


Explanation: The anchor point to be mapped has a value of 0, 
which means that it is not in use. Therefore, no links are 
checked. 


Internal DB2 Information ” | 
This message is issued by the following CSECT(s): DSNiMAP 


[geo ee End of Internal DB2 Information pene 


Severity: 4 (warning) 


System Action: Processing continues with the next set of 
parameters. 


DSN1834I GETMAIN FOR BUFFERS FAILED. NO MORE 


AVAILABLE STORAGE IN ADDRESS SPACE. 


Explanation: The GETMAIN for page buffers failed. There is no 
more virtual storage available in the address space. The table 
space being checked is too large to be processed with the 
current system configuration. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSN1IBUFM 


[| End of interna! DB2 information | 


Severity: 8 (error) 
System Action: Processing terminates. 


Problem Determination: Make changes to the system config- 
uration, if possible, to allow more virtual storage to be available 
in the address space. 
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DSN1950! DSN1COPY HAS SUPPRESSED VSAM OPEN 


VERIFY, 
ACBERRFLG = acb-error-code.open-option 


Explanation: DSNiCOPY suppresses the VSAM VERIFY done 
by the VSAM OPEN for the SYSUT1 data set. The VSAM VERIFY 
is not needed for the VSAM data sets used by DB2. For DB2 
VSAM data sets, the data set hi-used RBA in the ICF catalog is 
always current. 


a Internal DB2 Information ee 
This message is issued by the following CSECT(s): DSN1COPY 


[ee eae, End of Internal DB2 Information tee eel 


Severity: 0 (informational) 


System Action: Processing continues. 


DSN1951I ODD NUMBER OF HEX CHARACTERS SPECIFIED 


IN VALUE PARM. 


Explanation: The VALUE parameter contained an odd number 
of hexadecimal characters. Only even numbers of hexadecimal 
characters are allowed. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1VAL 


| send of Internal DB2 information ______——_| 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Correct the number of hexadecimal digits 
specified for the VALUE parameter and resubmit the job. 


Problem Determination: Refer to DSN1ICOPY documentation 
for parameter requirements. 


DSN1952! UNEXPECTED END OF INPUT DATA - CHECK FOR 
INVALID SPECIFICATION OF THE 32K PARAM- 


ETER. 


Explanation: End of data occurred for the image copy data set 
specified in SYSUT1 before the first page could be read. Either 
the wrong input data set was specified or 32K was specified 
even though the input data set contains 4K pages. 


| Internal DB2 Information a 
This message is issued by the following CSECT(s): DSN1ICOPY 


eee End of Internal DB2 Information _ 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Remove the 32K parameter if the input data 
set contains 4K pages, change the name of the input data set to 
specify a valid image copy, or remove the FULLCOPY or 
INCRCOPY parameter. __ 


Problem Determination: Refer to DSNICOPY documentation 
for parameter requirements. 


DSN19531 STARTING PAGE NUMBER REQUIRES AN INPUT 


DATA SET NAME OF data-set-name 


Explanation: The starting page number of the page range to be 
printed is inconsistent with the input data set specified. 


| ie : Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN1ICOPY, 
DSNiPRNT 


ee End of Internal DB2 Information _ 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Ensure that NUMPARTS, the 32K parameter 
(or its default of 4K), and the starting page number are correct. 
If it is correct, change the input data set name as indicated by 
the message. 


Problem Determination: Refer to DSNICOPY or DSNiIPRNT 
documentation for parameter requirements. 


DSN1955| SYSUT1 DD CARD IS MISSING 


Explanation: No SYSUT1 DD card was provided. 


[ : ~ Internal DB2 Information a 


This message is issued by the following CSECT(s): DSN1COPY, 
DSN1PRNT 


Ds fees End of internal DB2 Information re ett 


Severity: 8 (error) 
System Action: Processing terminates. 
User Response: Rerun the job with a SYSUT1 DD card. 


DSN1958i INVALID DATA SET NAME. 


Explanation: A DB2 table space was given an incorrect name. 


| Internal DB2 Information oye eh a6 
This message is issued by the following CSECT(s): DSN1ICHDS 


{| SS sEEnd of internal DB2 Information ____——_| 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Correct the output data set name if FULLCOPY 
or INCRCOPY were specified. If a page range is being printed, 
correct the input data set name. Refer to Section 2 (Volume 1) 
of Administration Guide for a discussion of DB2 data set naming 
conventions. 


DSN19591 BOTH FULLCOPY AND INCRCOPY PARAMETERS 


CANNOT BE SPECIFIED. 


Explanation: DSN1COPY cannot apply to both full images 
copies and incremental image copies in the same execution. 
The full image copies are applied first. Each incremental image 
copy must then be applied in separate steps, starting with the 
oldest incremental copy. 


DSN1953! — DSN1962I 


a Internal DB2 information ee 
This message is issued by the following CSECT(s): DSN1ISDEF 


a End of Internal DB2 Information epee 


Severity: 8 (error) 
System Action: Processing will terminate. 


User Response: Omit either FULLCOPY or INCRCOPY. 


DSN19601 ALLOCATION ERROR. ERROR FIELD IS ERRFIELD 


value. INFORMATION FIELD IS INFFIELD value 


Explanation: The allocation of a data set has failed. 
‘ERRFIELD value' contains the error number that was issued. 
‘INFFIELD vaiue' contains the information number that was 
issued. See the SVC 99 error codes in MVS/ESA System Pro- 
gramming Library: Application Development Guide for help in 
determining the cause of the error. 


ae Internal DB2 Information ee al 
This message is issued by the following CSECT(s): DSN1ALLO 


acne End of Internal DB2 Information ee 


Severity: 8 (error) 
System Action: Processing will terminate. 


User Response: Correct the cause of the allocation error and 
resubmit the job. 


DSN19611 PIECE NUMBER value IS INVALID. 


Explanation: A page was retrieved that has a piece number 
greater than NUMPARTS for partitioned table spaces or greater 
than the default of 32 for linear table spaces. 'DPIECNUM 
value' is the piece number for the retrieved page. For page 
range printing, this message is issued if the starting page 
number has an invalid piece number as determined from calcu- 
lations involving NUMPARTS and the page size. 


| Internal DB2 Information ae ae ie | 
This message is issued by the following CSECT(s): DSN1CHDS 


ares End of Internal DB2 Information es 


Severity: 8 (error) 
System Action: Processing will terminate. 


User Response: Look in SYSIBM.SYSTABLESPACE for the 
correct number of partitions for this page. Correct NUMPARTS 
or 32K if they were specified incorrectly, resubmit the job with a 
valid image copy, or correct the starting page number for page 
range printing. 


DSN19621 OUTPUT DATA SETS MUST BE VSAM WHEN 
IMAGE COPY DATA SETS ARE USED AS INPUT TO 


DSNICOPY. 


Explanation: !f IMAGE COPY data sets are used as input to 
DSN1ICOPY, the output data sets must be VSAM. QSAM data 
sets cannot be used for output. 
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| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNiCOPY 


—— a End of Internal DB2 Information soe ee ese 


Severity: 8 (error) 
System Action: Processing will terminate. 


User Response: Change the output data set to VSAM, or 
remove the FULLCOPY and NUMPARTS parameters. 


DSN1963! ZERO PAGES ARE INVALID WHEN IMAGE COPY 


DATA SETS ARE USED AS INPUT TO DSN1COPY 
OR DSN1PRNT. 


Explanation: A page in an IMAGE COPY data set has a zero 
header. Pages with zero headers are illegal if IMAGE COPY 
data sets are used as input to DSN1COPY or DSN1PRNT 


| Internal DB2 Information Vee . tl 


This message is issued by the following CSECT(s): DSN1COPY, 
DSN1PRNT 


eae eae End of Internal DB2 Information | 


Severity: 4 (warning) 
System Action: Processing continues. 


User Response: Ifthe IMAGE COPY data set name was invalid, 
look in SYSIBM.SYSCOPY for valid names. Resubmit the valid 
IMAGE COPY data set to DSN1COPY/DSN1PRNT. If the IMAGE 
COPY data set had a valid name, use the REPAIR utility to 
replace the zero pages with valid data pages. 


DSN1964I NO VALUE HAS BEEN SPECIFIED FOR THE 


NUMBER OF PARTITIONS. 


Explanation: No value has been given for the number of parti- 
tions. This value should follow the 'NUMPARTS' parameter. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNIGVAL 


foe pesos End of Internal DB2 Information eee ote al 


Severity: 8 (error) 
System Action: Processing will terminate. 


User Response: Look in SYSIBM.SYSTABLESPACE for the 
correct number of partitions for this page. Specify the correct 
number of partitions and resubmit the job. If the page is not 
partitioned, then either omit the NUMPARTS parameter or 
specify NUMPARTS as zero. 


DSN19651 THE PARTITION NUMBER VALUE IS INVALID. 


Explanation: The partition number value following the 
'NUMPARTS' parameter is not between 1 and 64. 
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fe So Internal DB2 Information a al 
This message is issued by the following CSECT(s): DSNIGVAL 


[setae cree End of Internal DB2 Information a ee 


Severity: 8 (error) 
System Action: Processing will terminate. 


User Response: Look in SYSIBM.SYSTABLESPACE for the 
correct number of partitions for this page. 


DSN1966l OUTPUT DATA SET odsname NOT FOUND 


Explanation: DB2 cannot find 'odsname' because it has not 
yet been defined. 


| Internal DB2 Information : 
This message is issued by the following CSECT(s): DSN1ALLO 


Mee Reet End of Interna! DB2 Information Be etree tt st| 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Use access method services to define 
‘odsname' and any other VSAM data sets that have not yet 
been defined. 


DSN19671 THE OBID ARRAYS ARE FULL 


Explanation: More than 100 records of OBIDs were specified in 
the SYSXLAT file. 


a Internal DB2 Information a es 
This message is issued by the following CSECT(s): DSN1SYSX 


ar End of Internal DB2 Information ea Sets 


Severity: 8 (error) 
System Action: Processing is terminated. 


Problem Determination: DSNi1COPY cannot be used for table 
spaces containing more than 100 tables. 


DSN1968! OBIDS SHOULD NOT BE DUPLICATED 


Explanation: There should not be any repeated source OBIDs 
or target OBIDs within the SYSXLAT file. 


a Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1SYSX 


Nicaea End of Internal DB2 Information _ 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Change the SYSXLAT file. 


DSN19691 SYSXLAT FILE CAN NOT BE OPENED 


Explanation: The QSAM OPEN for the SYSXLAT file has failed 
because no DD card was provided. 


| Internal DB2 information | 
This message is issued by the following CSECT(s): DSN1SYSX 


eee fe ee End of Internal DB2 Information Gah tested 


Severity: 8 (error) 
System Action: Processing is terminated. 
User Response: Notify system programmer. 


System Programmer Response: Provide a SYSXLAT DD card if 
OBID transiate is to be done. Otherwise, remove the SYSXLAT 
parameter and rerun. 


Problem Determination: Follow standard QSAM diagnostic 
procedures. 


DSN19701 DATA PAGE CONTAINING OBID 'xxxx', HAS NO 


MATCHING VALUE IN THE SYSXLAT FILE 


Explanation: One of the OBID records of the SYSXLAT file con- 
tains a source OBID value that does not match the OBID vaiue 
of the source system. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSNITRAN 


Hes aden End of Internal DB2 information ete 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide that record of the SYSXLAT file which 
contains an unmatched OBID value with an OBID that matches 
the OBID value of the source system. 


DSN1971I DBID 'xxxx' NOT FOUND IN THE SYSXLAT FILE. 


REPLACE SOURCE DBID 'xxxx' OF THE SYSXLAT 
FILE WITH IT. 


Explanation: The first record of the SYSXLAT file has the incor- 
rect source DBID value. 


~ Internal DB2 Information a fl 
This message is issued by the following CSECT(s): DSNITRAN 


| End of internal DB2 Information _______| 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the first record of the SYSXLAT file 
with a source DBID value which matches the DBID value of the 
source system. 


DSN19691 — DSN1975I 


DSN1972I PSID 'xxxx' NOT FOUND IN THE SYSXLAT FILE. 


REPLACE SOURCE DBID 'xxxx' OF THE SYSXLAT 
FILE WITH IT. 


Explanation: The second record of the SYSXLAT file has the 
incorrect source PSID value. 


| ” internal DB2 Information 
This message is issued by the following CSECT(s): DSNITRAN 


a End of Internal DB2 Information ee 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the second record of the SYSXLAT file 
with the correct PSID value. 


DSN19731 SOURCE DBID IS MISSING 


Explanation: The first record of the SYSXLAT file contains no 
DBID value. 


[ 7: Internal DB2 Information 
This message is issued by the following CSECT(s): DSN1ISYSX 


er End of internal DB2 Information eee 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the first record of the SYSXLAT file 
with a pair of source and target DBID values which match the 
DBID values of the source and target systems. 


DSN19741 TARGET DBID tS MISSING 


Expianation: The first record of the SYSXLAT file contains no 
target DBID value. 


Internal DB2 Information as | 
This message is issued by the following CSECT(s): DSN1SYSX 


ee End of Internal DB2 Information _ 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the first record of the SYSXLAT file 
with a target DBID value which matches the DBID value of the 
target system. 


DSN19751 SOURCE PSID IS MISSING 


Explanation: The second record of the SYSXLAT file contains 
no PSID value. 
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[~ ag eae Internal DB2 Information 
This message is issued by the following CSECT(s): DSN1SYSX 


End of Internal DB2 Information ee, 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the second record of the SYSXLAT file 
with a pair of source and target PSID values which match the 
PSID values of the source and target systems. 


DSN1976 TARGET PSID IS MISSING 


Explanation: The target PSID is missing from the second 
record of the SYSXLAT file. 


| Internal DB2 Information Gate oo | 
This message is issued by the following CSECT(s): DSN1SYSX 


ee ae End of Internal DB2 Information eee 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the second record of the SYSXLAT file 
with a target PSID value which matches the PSID values of the 
target system. 


DSN19771 SOURCE OBID IS MISSING 


Explanation: There is a record in the SYSXLAT file with no 
OBID value. 


‘a Internal DB2 Information Bie 
This message is issued by the following CSECT(s): DSN1SYSX 


Po het End of Internal DB2 Information _ 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Correct the SYSXLAT file so that all the 
records following the first and second records will contain a 
pair of source and target OBID values. 


DSN19781 TARGET OBID IS MISSING 


Explanation: There is a record in the SYSXLAT file with no 
target OBID value specified. 


[ Internal DB2 Information ~ zo | 
This message is issued by the following CSECT(s): DSN1SYSX 


a ts End of Internal DB2 Information a 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the SYSXLAT file with an OBID value 
that matches the OBID vatiue of the target system. 
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DSN19791 SOURCE AND TARGET VALUES SHOULD BE 


< =9999 


Explanation: The SOURCE and TARGET values of the SYSXLAT 
file should be between 1 and 9999. 


| Internal DB2 Information =a ie 
This message is issued by the following CSECT(s): DSN1SYSX 


| End of Internal DB2 Information ___ 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Provide the SYSXLAT file with values that are 
between 1 and 9999. OBID value of the target system. 


DSN19801I BROKEN PAGE BIT SET, WILL RESET AND RETRY 


BROKEN PAGE TEST 


Explanation: This message indicates that a broken page was 
detected. If message DSN1990I is issued following this 
message, determine the cause of the broken page. If message 
DSN19901 is not issued, reset the broken page bit with the 
REPAIR utility to correct the problem. Refer to Section 4 of 
Diagnosis Guide and Reference for additional information. 


ae Internal DB2 Information is || 
This message is issued by the following CSECT(s): DSNiICOPY 


Vg See End of Interna! DB2 Information tot oats 


Severity: 4 (warning) 

System Action: Processing continues. 

User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Use either the RECOVER or 
REPAIR utility to correct the broken page. Refer to Section 4 of 
Diagnosis Guide and Reference for additional information. 


Problem determination should have been done when the dump 
associated with the setting of the broken page bit was 
requested. 


DSN19811 INVALID PARAMETER FIELD: bad-parameter 


Explanation: An invalid input parameter was detected on the 
EXEC card. The parameter is either not a valid keyword or it 
has invalid subparameters associated with it. 


Examples of invalid subparameters are: 


¢ The NUMPARTS subparameter was other than '(nn)'. 'nn' 
is a decimal number. 

¢ The NUMPARTS subparameter was missing either a left or 
right parenthesis. 

¢ The PRINT subparameter was missing either a left or right 
parenthesis. 

¢ The PRINT subparameter specified a digit in a page number 
which was not hexadecimal. 

¢ The PRINT subparameter contained a starting page number 
that is larger than the ending page number. 

® The PRINT subparameter contains a page number larger 
than six hexadecimal digits. 


| internal DB2 Information | 


This message is issued by the following CSECT(s): DSN1ICOPY, 
DSN1PRNT 


[keer End of Internal DB2 Information Bees 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Correct the indicated parameter on the EXEC 
DD statement, and resubmit the job. 


Problem Determination: Refer to DSN1ICOPY or DSNIPRNT 
documentation for parameter requirements. 


DSN19821 NO BLANKS ARE ALLOWED WITHIN THE PARAM- 


ETER LIST 


Explanation: There is a space or spaces between one or more 
parameters in the utility list. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSNICOPY, 
DSN1PRNT 


acre ee End of internal DB2 Information eee 


Severity: 8 (error) 
System Action: Processing is terminated. 


User Response: Check the parameter list and make sure that 
there are no spaces between any of the parameters. 


DSN19841 UNEXPECTED PAGE NUMBER, EXPECTING: 


expected-page-number 


Explanation: This message indicates that an unexpected page 
number was encountered. The ‘expected page number ' that is 
displayed (in hexadecimal) is the page number that was 
expected, not the one that was encountered. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN1ICOPY 


| aoe End of Internal DB2 Information eee aoe al 


Severity: 4 (warning) 
System Action: Processing continues. 
User Response: Notify the system programmer. 


System Programmer Response: Use the REPAIR utility to 
dump the table space or index space. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures 
and for additional information. 


DSN1982i — DSN1992I 


DSN19851 ZERO PAGES ENCOUNTERED. FIRST PAGE = 
first-zero-page-number, LAST PAGE = last-zero- 


page-number 


Explanation: One or more pages consisting of all zeros were 
encountered with valid data pages after them. The 'first zero 
page number' and the 'last zero page number' that are dis- 
played (in hexadecimal) are the pages where zeros were first 
encountered and last encountered, respectively. This is a 
normal condition when an index has been created with a free 
page parameter not equal to zero. 


~~ Internal DB2 information = | 


This message is issued by the following CSECT(s): DSN1COPY, 
DSN1IPRNT 


Ls End of Internal DB2 Information Sd 


Severity: 4 (warning) 
System Action: Processing continues. 
User Response: Notify the system programmer. 


System Programmer Response: If the table space or index 
space must be restored, use the RECOVER utility to restore the 
table space or index space, then rerun the job. If the zero page 
is the result of using the free page parameter, the zero page is 
normal and no recovery is needed. Refer to Section 4 of Diag- 
nosis Guide and Reference for additional information. 


DSN19901 BROKEN PAGE. PAGE NUMBER = broken-page- 
number. CODE = X trace-code. REASON: 


comment. 


Explanation: The module indicated by ‘trace-code' has 
detected a broken page. The ‘trace-code' and the 'comment' 
fields are identical to those described for DSNICPGE and 
DSNKCPGE in the CSECT Directory, which is in data set 
DSN220.DSNSAMP(DSNWMODS). The page number is dis- 
piayed in hexadecimal format. 


| ~ Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSNICPGE DSNKCPGE DSNiCOPY 
DSN1PRNT 


ae ere End of Internal DB2 Information ee | 


Severity: 4 (warning) 

System Action: Processing continues. 

User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Use either the RECOVER or 
REPAIR utility to correct the broken page. Refer to Section 5 
(Volume 2) of Administration Guide and Section 4 of Diagnosis 
Guide and Reference for additional information. 


DSN19921 VSAM PUT ERROR, RPLERREG = return-code, 


RPLERRCD = reason-code 


Explanation: VSAM PUT has failed with the indicated error 
code. 


DB2 Messages 3-277 


DSN1993!1 — DSN1998! 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNICOPY 


Woetereks ost End of Internal DB2 Information et aoe eal 


Severity: 8 (error) 
System Action: Processing terminates. 
User Response: Notify system programmer. 


System Programmer Response: Follow standard VSAM diag- 
nostic procedures. 


DSN19931 DSN1COPY/DSN1PRNT TERMINATED, page-count 


PAGES PROCESSED 


Explanation: This message indicates that DSN1COPY or 
DSN1PRNT has not successfully completed processing. The 
page count is displayed in decimal format. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN1COPY, 
DSN1PRNT 


ee eer aee End of Internal DB2 Information pe eh 


Severity: 8 (error) 
System Action: Processing terminates. 


User Response: Examine the previous error message of the 
application program. 


System Programmer Response: Examine the previous error 
message of the application program. 


Problem Determination: Examine the previous error message 
of the application program. 


DSN1994I DSN1ICOPY/DSN1PRNT COMPLETED SUCCESS- 


FULLY, page-count PAGES PROCESSED 


Explanation: This message indicates that DSN1COPY or 
DSN1PRNT has successfully completed processing. The page 
count is displayed in decimal format. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN1COPY, 
DSN1PRNT 


a ee End of Internal DB2 Information ee 


Severity: 0 (informational) 


System Action: Processing terminates. 


DSN1995! VSAM GET ERROR, RPLERREG = return-code, 


RPLERRCD = reason-code 


Explanation: VSAM GET has failed with the indicated error 
code. 


3-278 DB2 Messages and Codes 


[ Pe ~ {nternal DB2 information ~— | 


This message is issued by the following CSECT(s): DSN1COPY, 
DSN1PRNT 


bircca et ol ne End of Internal DB2 Information ee ee 


Severity: 8 (error) 
System Action: Processing terminates. 
User Response: Notify system programmer. 


System Programmer Response: Follow standard VSAM diag- 
nostic procedures. 


DSN1996! VSAM OPEN ERROR, ACBERRFLG = ACB error- 


code. OPEN option 


Explanation: VSAM OPEN has failed with the indicated 'ACB 
error-code'. The OPEN option was either 'INPUT' or 
‘OUTPUT'. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN1COPY, 
DSN1IPRNT 


Neos ee End of Internal DB2 information _ id 


Severity: 8 (error) if error is greater than or equal to 128; oth- 
erwise, severity code is 4. 


System Action: Processing terminates if error code is greater 
than or equal to 128; otherwise, processing continues normally. 


User Response: Notify system programmer. 


System Programmer Response: Follow standard VSAM diag- 
nostic procedure. 


DSN19971 OUTPUT DSNAME = data-set-name, data-set-type 


Explanation: The indicated ‘data set name' is used for output. 
‘data set type' is either VSAM or SEQ (for sequential). 


C ~~ Internal DB2 Information 
This message is issued by the following CSECT(s): DSNICOPY 


ie ee ee, End of Internal DB2 Information hae a ae el 


Severity: 0 (informational) 


DSN19981 INPUT DSNAME = data-set-name, data-set-type 


Explanation: The indicated 'data-set-name' is used for input. 
'data-set-type' is either VSAM or or SEQ (indicating sequen- 
tial). 


| internal DB2 Information ~~ += -=4 


This message is issued by the following CSECT(s): DSN1COPY, 
DSNiPRNT 


(Cope End of Internal DB2 Information Sete eM 


Severity: 0 (informational) 


DSN19991 START OF DSN1COPY/DSN1PRNT FOR JOB job- 


name step-name 


Explanation: This message indicates that DSN1COPY has 
started processing. 


DSN19991 — DSN19991 


Interna! DB2 Information 


This message is issued by the following CSECT(s): DSN1ICOPY, 
DSN1IPRNT 


Pees End of Internal DB2 Information ee eee 


Severity: 0 (informational). 


System Action: DSN1COPY/DSN1PRNT starts processing. 
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DSN3001!1 — DSN3006I 





Subsystem Support Subcomponent Messages (DSN3...) 


DSN3001! csect-name ABNORMAL DISCONNECT FROM 


SUBSYSTEM INTERFACE 


Explanation: This message indicates that 'csect-name' has 
discovered that an online routine was still supporting SSI calls 
(IEFSSREQ) even though DB2 was nearly done terminating or 
no longer executing. This occurs with 'csect-name' DSN3RS00 
or DSN3RSOX when the service address space has reached 
end-of-memory and neither normal termination nor online error 
recovery routines have successfully completed termination of 
the DB2 subsystem. This occurs with 'csect-name' DSN3SSTM. 
when this condition is discovered during online termination. 


| Internal DB2 Information = | 


This message is issued by the following CSECT(s): DSN3RSO0, 
DSN3SSTM, DSN3RSOX 


Sonera ten End of Internal DB2 Information a es 


System Action: The connection is terminated. All IEFSSREQ 
requests are handled by the DB2 ERLY code until DB2 is 
restarted. 


Problem Determination: An SVC dump is requested. This SVC 
dump and associated SYS1.LOGREC entries provide informa- 
tion to determine which resource managers had not removed 
their support of particular SSI function codes. 


For dumps requested by DSN3RS00 or DSN3RSOX, all pertinent 
control blocks and stack storage are dumped. The primary 
control block of interest is the SSVT for DB2. 


For DSN3SSTM, the DB2 'standard dump' facility is used to 
dump the information necessary for problem diagnosis. The 
primary control blocks of interest are the 'active' CONN blocks. 


DSN3002! RECOVERY INCOMPLETE FOR connection-name 


Explanation: At least one DB2 unit of recovery (UR), related to 
an identified subsystem ('connection-name'), is still ‘indoubt' 
after restart synchronization has taken place. ('Indoubt' URs 
are those for which commit has been voted by DB2 but which 
have not been acknowledged by 'connection-name'.) 


This message may appear if the 'connection-name' subsystem 
has begun to do new work before having resolved all indoubt 
URs. The 'connection-name' subsystem may be in the process 
of resolving the indoubt URs. 


~ Internal DB2 Information Gl 
This message is issued by the following CSECT(s): DSN3ID30 


er eer ee End of Interna! DB2 Information eka snk 


System Action: Resources held (locked) by these ‘indoubt' 
URs are unavailable to any other work units until their status is 
resolved. 


System Programmer Response: The system programmer 
and/or system administrator must determine the correct 
recovery action to resolve the 'indoubt' situations. This 
involves either 'ensure-commit' or 'backout' decisions for all 
‘indoubt' URs. 


The -DISPLAY THREAD command shouid be used to see the 
URs still indoubt. It may show that all indoubt URs have already 
been resolved. The -RECOVER INDOUBT command should be 
used, either from an MVS console or through an attachment 
facility, to resolve the indoubt URs and to release the resources 
they hold. 


Problem Determination: This error is probably caused by a 
cold start after an abnormal termination of either subsystem or 
by offline alterations of the logs of either subsystem. 


DSN3004! DESCRIPTOR GET FAILURE RC = X xxxxxxxx, 


REASON = X xXxxxxxxx 


Explanation: The parameter list required to create the DB2 
agents under which IEFSSREQ calls are processed could not be 
obtained from the subsystem support subcomponent directory 
of internal parameters (DSN3DIR1). The RC indicates the return 
code received from the system parameter manager and 
REASON indicates the reason code (from register 0). 


The return code is always 4 when this message is presented, 
indicating that the IEFSSREQ descriptor was not found in the 
subsystem support subcomponent directory. This is a system 
error and results in termination of the DB2 subsystem. The 
reason code is always 0. 


[ = Internal DB2 Information Se 4- | 
This message is issued by the following CSECT(s): DSN3SSIN 


eee End of Internal DB2 Information eee 


System Action: Subsystem initialization is discontinued. Ter- 
mination occurs. 


System Programmer Response: Repair the master directory 
(DSNZPARM) and/or the DB2 program libraries, and restart the 
DB2 subsystem. 


Problem Determination: If the problem persists, use any 
dumps and the console log to diagnose the problem. For addi- 
tional information, refer to Section 5 of Diagnosis Guide and 
Reference. 


DSN30061 xxxx SSI FUNCTION WAS ALREADY ACTIVE WHEN 


ACTIVATE WAS ATTEMPTED 


Explanation: An initialization sequence error has occurred. 
The subsystem support for SSI services resource manager 
(SSSS) has discovered during its initialization that another 
resource manager ('xxxx') has already activated the EOM or 
FEOT SSI call by calling DSN3ACO00 or DSN3ACOX. If this 
occurs, the error is a serious one. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN3SSIN 


Es End of Internal DB2 Information eee ee] 


System Action: Subsystem initialization is discontinued. DB2 
termination occurs. 
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DSN3007I — DSN3102I 


System Programmer Response: Ensure that all maintenance 
has been applied to the DB2 program libraries, and then restart 
the DB2 subsystem. 


Problem Determination: if the problem persists, use any 
dumps and the console log to diagnose the problem. For addi- 
tional information, refer to Section 5 of Diagnosis Guide and 
Reference. 


DSN30071 xxxx SSI FUNCTION WAS ALREADY INACTIVE 


WHEN DEACTIVATE WAS ATTEMPTED 


Explanation: A termination sequence error has occurred. The 
subsystem support for SSI services resource manager (SSSS) 
has discovered during its termination that another resource 
manager ('xxxx') has already deactivated the EOM or FEOT 
SS! call by calling DSN3ACO00 or DSN3ACOX. If this occurs, the 
error is a serious one. 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN3SSTM 


(oie ee End of internal DB2 Information eee 


System Action: Termination continues. 


System Programmer Response: Ensure that all maintenance 
has been applied to the DB2 program libraries. 


Problem Determination: If the problem persists, use any 
dumps and the console log to diagnose the problem. For addi- 
tional information, refer to Section 5 of Diagnosis Guide and 
Reference. 


DSN3008I csect-name ABNORMAL DISCONNECT FOR 


PROGRAM REQUEST HANDLER(S) 


Explanation: This message indicates that 'csect-name' has 
discovered that one or more resource managers are still sup- 
porting application program calis through their program 
request handler, even though DB2 was almost done terminating 
or was no longer executing. This occurs when the system ser- 
vices address space has gone to end of memory and neither 
normal termination nor online error recovery routines have 
successfully completed termination of the DB2 subsystem. 


| Internal DB2 Information ~—————~—S vA 


This message is issued by the following CSECT(s): DSN3RSO0, 
DSN3RSOX 


ef Acs End of Internal DB2 Information ee 


System Action: The program request handler (PRH) connection 
is terminated. All application program support requests are 
rejected with an indication that DB2 is not up. 


System Programmer Response: See the Problem Determi- 
nation section of this message. 


Problem Determination: An SVC dump is requested. This SVC 
dump and associated SYS1.LOGREC entries provide informa- 
tion to determine which resource managers were still sup- 
porting application program support calls. All pertinent control 
blocks and stack storage are dumped. The primary control 
block of interest is the program request handler block (PRHB). 
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DSN3100! csect-name SUBSYSTEM ssnm READY FOR 


START COMMAND 


Explanation: This message is issued by CSECT DSN3UR00 
when DB2 subsystem initialization is complete. The 'ssnm' in 
the message is the name of the subsystem that issued the 
message. This occurs during MVS IPL processing. The 
message is also issued by CSECT DSN3ECO00 or DSN3ECOX 
after termination of the previous execution of DB2 is complete. 
Message DSN3104I is also issued during this processing. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN3URO0, 
DSN3EC00, DSN3ECOX 


[| End of Internal DB2 Information 


Operator Response: Issue the -START command when DB2 
execution is desired. 


DSN31011 csect-name INVALID EARLY PROCESSING 
MODULE NAME IN PARMLIB RECORD. ssnm IS 


NOT AVAILABLE 


Explanation: CSECT DSN3UR00 has discovered that a param- 
eter passed to DB2 subsystem initialization is in error. Either 
the Early processing load module name is not between 1 and 8 
characters long, or there are syntax errors in the parameter 
string. The entire parameter string must be between 3 and 10 
characters long, and the next to the last character must be a 

','. The parameters were obtained from the parameter fields of 
a record defining a DB2 subsystem in member IEFSSNxx of 
SYS1.PARMLIB. 


The subsystem recognition character is not inserted in this 
message as it is not yet known. 'ssnm' is the name of the DB2 
subsystem undergoing IPL-time initialization. 


| internal DB2 Information | 
This message is issued by the following CSECT(s): DSN3UR00 


ee End of internal DB2 Information i | 


System Action: The DB2 subsystem with the indicated name is 
not available for this IPL of MVS. 


Operator Response: Notify the system programmer. 


System Programmer Response: Correct the parameter fields 
in the record of SYS1.PARMLIB member JEFSSNxx, and re-IPL 
MVS. Refer to Section 2 (Volume 1) of Administration Guide for 
the format of an IEFSSNxx record which defines a DB2 sub- 
system. 


DSN3102I csect-name INVALID SUBSYSTEM RECOGNITION 
CHARACTER IN PARMLIB RECORD. ssnm IS NOT 


AVAILABLE 


Explanation: CSECT DSN3URO00 has discovered that the sub- 
system recognition character is invalid; it must be nonblank. 
The subsystem recognition character is the last field of the 
parameter string passed to DB2 IPL initialization. It is obtained 
from a record for the named subsystem in member IEFSSNxx of 
SYS1.PARMLIB. 


The subsystem recognition character is not inserted in this 
message as it cannot be determined. 'ssnm' is the name of 
the DB2 subsystem undergoing IPL-time initialization. 


| a ia Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN3UR00 


ees End of internal DB2 Information bee | 


System Action: The DB2 subsystem with the indicated name is 
not available for this IPL of MVS. 


Operator Response: Notify the system programmer. member 
IEFSSNxx, and re-IPL MVS. Refer to Section 2 (Volume 1) of 
Administration Guide for the format of an IEFSSNxx record 
which defines a DB2 subsystem. 


DSN31031 csect-name - UNABLE TO LOAD EARLY PROC- 
ESSING MODULE SPECIFIED IN PARMLIB 


RECORD. ssnm IS NOT AVAILABLE 


Explanation: CSECT DSN3URO0 is unabie to load the early 
processing load module named in the first parameter passed to 
DB2 subsystem IPL initialization. 'ssnm' is the name of the 
DB2 subsystem undergoing IPL-time initialization. 


Either the load module name was specified incorrectly or the 
load module does not reside in a library included in the MVS 
linklist. 


| internal DB2 Information a == 
This message is issued by the following CSECT(s): DSN3UR00 


Tesaeek toe ee End of Interna! DB2 Information ieee hd 


System Action: DSN3URO0 abends with code X'04E' and 
reason code X'00F30103'. The DB2 subsystem with the indi- 
cated name is not available for this IPL of MVS. 


Operator Response: Notify the system programmer. 


System Programmer Response: Identify the cause of the error. 
Either correct the early processing load module or take the 
necessary steps to include the module in a link-listed library. 
Re-iPL MVS. Refer to Section 2 (Volume 1) of Administration 
Guide for the format of an IEFSSNxx record which defines a DB2 
subsystem. Refer to the appropriate MVS publication for MVS 
linklist requirements. 


Problem Determination: An entry is made to SYS1.LOGREC. 
No SVC dump is taken. 


DSN31041 ~=csect-name - TERMINATION COMPLETE 


Explanation: This message indicates that a DB2 subsystem 
has terminated. The DB2 address spaces will have completed 
earlier. This message is presented for every termination, 
normal or abnormal. 


a ~ Internal DB2 Information ~_ nes 


This message is issued by the following CSECT(s): DSN3ECO00, 
DSN3ECOX 


eer End of Internal DB2 Information trea 


DSN3103I — DSN3107I 


DSN31051 =csect-name - UNABLE TO LOAD EARLY PROC- 
ESSING MODULE 'DSN3EPX' ssnm IS NOT 


AVAILABLE 


Explanation: CSECT DSN3URO00 is unable to load the early 
processing module DSN3EPX required for MVS. The name of 
the DB2 subsystem undergoing !PL-time initialization is 'ssnm'. 
Either the load module has been inadvertently deleted, or does 
not reside in a library included in the MVS linklist. 


| Internal DB2 Information ~—_ ae 
This message is issued by the following CSECT(s): DSN3UR00 


ane eae! End of Internal DB2 Information fe See 


System Action: DSN3UR00 abends with code X'04E' and 
reason code X'00F30105'. DB2 subsystem 'ssnm' is not avail- 
able for this IPL of MVS. 


Operator Response: Notify the system programmer. 


System Programmer Response: Identify the cause of the error. 
Either correct the early processing load module or take the 
necessary steps to include the module in a link-listed library. 
Re-IPL MVS. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: An entry is made in SYS1.LOGREC. 
No SVC dump is taken. Refer to MVS linklist requirements in 
the Initialization and Tuning Guide. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


DSN3106I csect-name SUBSYSTEM STOPPED. THIS 


COMMAND NOT PROCESSED: command-text 


Explanation: A command has been received which cannot be 
processed due to one of the following: 


¢ The DB2 subsystem has not been started. 


* The command was queued for processing while DB2 was 
starting, but startup terminated with an error. 


¢ DB2 terminated before the command could be processed. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN3ECOO, 
DSNSECOX 


[eee et eee End of Internal DB2 Information beet 


System Action: The command is not processed. 


Operator Response: Start the DB2 subsystem, then reenter the 
command. 


DSN31071 csect-name COMMAND REJECTED. REQUESTOR 


NOT AUTHORIZED 


Explanation: CSECT DSN3ECO00 or DSN3ECOX has discovered 
that the source of the command was a console that does not 
have 'system' authority. 
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DSN3108I — DSN3201I 


| Internal DB2 Information SS 


This message is issued by the following CSECT(s): DSN3ECOO, 
DSN3ECOX 


ee dae End of Internal DB2 Information et 


System Action: The command is not processed. This message 
is sent to the console that entered the command. 


Operator Response: Enter the command from another console 
that has 'system' authority. 


System Programmer Response: Verify that this console should 
be used for entering DB2 commands. If so, authorize it for 
‘system' commands by using MVS services. 


DSN3108I csect-name COMMAND REJECTED. COMMAND 


FACILITY PATH UNAVAILABLE 


Explanation: CSECT DSN3EC00 or DSN3ECOX has discovered 
that the path from MVS consoles to the DB2 command 
processor is unavailable. It may still be possible to enter com- 
mands through one of the attachment facilities. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN3ECO0O, 
DSN3ECOX 


oe eee End of Internal DB2 Information a eee 


System Action: The command is not processed. This message 
is delivered to the console that entered the command. 


System Programmer Response: The console command facility 
is available again the next time DB2 is started. If it is necessary 
to regain this facility immediately, DB2 should be canceled and 

restarted. 


DSN31091 csect-name - UNABLE TO OBTAIN SUBSYSTEM 
AFFINITY TABLE INDEX FOR SUBSYSTEM ssnm. 


IEFSSREQ RC = nn 


Explanation: CSECT DSN3URO00 was unable to obtain a sub- 
system affinity table index for the named subsystem. MVS did 
not recognize the named subsystem name as a known sub- 
system. If this message is issued, a serious error has occurred 
in MVS or DB2. 


In the message, 'nn' is the return code from the IEFSSREQ 
MVS service. '‘ssnm' is the name of the DB2 subsystem under- 
going IPL-time initialization. 


| ~~~ Internal DB2 Information —~ i ae 
This message is issued by the following CSECT(s): DSN3UR00 


= End of Internal DB2 Information eee | 


System Action: DSN3UROO abends with completion code 
X'04E' and reason code X'00F30104'. The DB2 subsystem with 
the indicated name is not available for this IPL of MVS. 


Operator Response: Notify the system programmer. 


System Programmer Response: Try to re-IPL. If the problem 
persists, follow standard DB2 problem reporting procedures. 
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Problem Determination: A record is written to SYS1.LOGREC. 
No SVC dump is taken. Return codes from IEFSSREQ are docu- 
mented under control block SSOB in the appropriate MVS publi- 
cation. 


csect-name LOAD MODULE module-name DOES 
NOT HAVE AMODE(31) ATTRIBUTE. ssnm IS NOT 
AVAILABLE 


DSN31111 


Explanation: The DB2 program which establishes DB2 as an 
MVS subsystem during Master Scheduler initialization has 
determined that either its own load module or a load module 
loaded by it does not have the linkage editor attributes 
AMODE(31) and RMODE(ANY). Most DB2 load modules must 
be capable of running in the 31-bit addressing mode. 


In the message, 'csect-name' is the name of the program 
detecting the error, 'module-name' is the name of the first load 
module found with an invalid AMODE attribute, and 'ssnm' is 
the name of the DB2 subsystem undergoing IPL-time initializa- 
tion. 


| Internal DB2 Information : | 
This message is issued by the following CSECT(s): DSN3URO00 


ee oe End of Internal DB2 Information ie Sit 


System Action: Program DSN3UR00 abends with a code of 
X'04E' and a reason code of X'00F30111'. The DB2 subsystem 
named 'ssnm' is not initialized. The subsystem will not be 
available until the error is corrected and MVS is re-iPLed. 


Operator Response: Notify the system programmer of the 
failure. 


System Programmer Response: Verify that all of the following 
were done: 


e The installation and maintenance activities against DB2 
were executed using SMP. 


¢ The JCLIN for SMP included the correct AMODE and 
RMODE control statements. 


¢ The appropriate Linkage Editor provided with the Data 
Facility Product (DFP) for the version of MVS being used 
was invoked by SMP for the link-edit steps. 


Correct and rerun the procedure or JCL which caused the 
error. If necessary, REJECT all SMP APPLY steps which were 
executed incorrectly and rerun the rejected steps. Request a 
re-IPL of MVS. 


Problem Determination: A record is written to SYS1.LOGREC. 
No SVC dump is taken. 


The MVS service aid AMBLIST provides Linkage Editor module 
attributes in the summary section of the LISTLOAD function 
output. 


DSN32011 ABNORMAL EOT IN PROGRESS FOR 
USER = xxxxxxxx CONNECTION-ID = yyyyyyyy 


CORRELATION-ID = zzzzzzzzzzzz 


Explanation: Abnormal termination processing has been 
started for the agent described by the USER, CONNECTION-ID, 
and CORRELATION-ID identifiers. 


The abnormal termination could be the result of a failure in the 
allied agent address space or the result of an operator cancel 
command. 


The value for the CORRELATION-ID may be blank. If the termi- 
nating agent is connected to DB2 at the IDENTIFY level (that is, 


it is not signed on or is not authorized to a plan) at the time of 
the failure, no CORRELATION-ID is associated with the agent. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN3EOTO, 
DSN3AAES 


ere eee End of Internal DB2 Information ee | 


System Action: The agent is queued to a System Services 
service task for termination processing. Any uncommitted data- 
base changes wil! be rolled back. 


User Response: Your job or TSO session cannot be canceled. 
The PA1 key will have no affect in this circumstance. To avoid 
long waits when your application program is canceled or termi- 
nates abnormally, issue frequent commits. 


System Programmer Response: See the Problem Determi- 
nation section for this message. The MVS CANCEL and FORCE 
commands will have no effect and should not be issued. DB2 
should not be canceled. If an extensive rollback is in progress, 
the subsequent DB2 restart may take a very long time due to 
additional log activity. 


Problem Determination: You can detect a deferred termination 
condition for a task by examining several indicators. Some or 
all of the following may be present: 


¢ This message, DSN3201I, is written to the MVS console 
immediately following the queuing of the agent onto the 
service task work queue. 

¢ The allied address space may be swapped out and appear 
to be in a never ending WAIT condition. 

¢ The MVS commands CANCEL and FORCE appear to have 
no effect. 

e The allied task holds an MVS shared ENQ on resource 
SYSZDSN3.ERLYOLRHerly-block-address. 

¢ During abnormal termination of the agent associated with 
the failing task, the task’s connection will appear on the 
-DISPLAY THREAD output with either a 'Q' or ‘QD' status. 
See message DSNV404I for the definition of these status 
codes. 


DSN34581 — DSN35801 


DSN34581 csect-name MODULE modname MUST HAVE THE 


AMODE (31) ATTRIBUTE 


Explanation: An authorization exit load module was not link- 
edited with the 31-bit addressing mode (AMODE) attribute. 
Either load module DSN3@ATH or DSN3@SGN is specified by 
‘modname'. 


| Internal DB2 Information | 
This message is issued by the following module(s): DSN3AMI1 


Ls End of internal DB2 Information = 


System Action: Subsystem startup is terminated. 


System Programmer Response: Relink-edit the authorization 
exit module specifying the attributes AMODE(31), RMODE(ANY). 


Problem Determination: Check the load module attributes 
used for the link-edit. 


DSN35801_ CONNECTION FOR [EOM | FEOT | IDEN] GAVE 


RC =X xxxxxxxx, REASON = X xxxxxxxx 


Explanation: A nonzero return code has been returned to 
DSNSAMI2 from the SSSS connect to subsystem interface cail. 
The variables in the message indicate which SSI call is involved 
and the actual return and reason codes associated with it. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSN3AMI2 


(lee eee End of internal DB2 information eae, 


System Action: The current task (TCB) is abended with a 
system completion code of X'04E' and with an abend reason 
code of '00F30580' The DB2 subsystem terminates. 


Operator Response: Notify the system programmer. 
System Programmer Response: Restart the DB2 subsystem. 


Problem Determination: The trace table and stack storage 
associated with the EB in register 6 must be examined to locate 
the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 
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DSN8000! — DSN8006E 





Sample Application Messages (DSN&8...) 


DSN8000! REQUEST IS: request 


Explanation: The input statement is listed as received. 


= ars Internal DB2 Information ~—————T ~ | 


This message is issued by the following CSECT(s): DSN8BD3, 
DSN8BF3 


[Ect Peta End of Internal DB2 Information eee 


System Action: The request is listed. 


User Response: See if the input request is what you want. 


DSN80011 csect EMPLOYEE NOT FOUND 


Explanation: The 'I' or 'list's request found no employee data 
that match your request. 


[tC~™ ~~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


eet to End of Internal DB2 Information Soot da wl 


System Action: No employees are listed. 


User Response: If no employee data was expected to be found, 
continue. 


Problem Determination: If the error is unexpected, list the con- 
tents of the employee and department views VEMP and VDEPT 
to determine why the entry is missing. 


DSN80021 


Explanation: Empioyee data was added as requested. 


csect EMPLOYEE SUCCESSFULLY ADDED 


a Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


[i sesee oes End of Internal DB2 Information eee 


System Action: The request was executed successfully. 


DSN80031 csect EMPLOYEE SUCCESSFULLY ERASED 


Explanation: Data for an employee was erased as requested. 


aa ~_ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


Def 28 End of interna! DB2 Information Pee | 


System Action: The request was executed successfully. 


DSN80041 csect EMPLOYEE SUCCESSFULLY UPDATED 


Explanation: Data for an employee was updated as requested. 


Internal DB2 Information are aaa 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8BP3 DSN8CP3 DSNB8IP3 
DSN8MCF DSN8MCG DSN8MDG 
DSN8MPF DSN8MPG 


Mote te eee End of Internal DB2 Information tenes Bote 


System Action: The request was executed successfully. 


DSNS005E  csect EMPLOYEE EXISTS ALREADY, ADD NOT 


DONE 


Explanation: A request was made to add data for a new 
employee, but the employee number already exists. 


[ ieee ~— Internal DB2 Information ~ | 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


Ne tee, End of Internal DB2 Information pene atl 


System Action: No employee data is added. 


User Response: Display the existing employee data. If this is 
the desired employee, update the employee entry. Otherwise, 
choose a new employee number. 


Problem Determination: List the contents of the employee 
view, VEMP, and the department view, VDEPT. © 


DSN8006E  csect EMPLOYEE DOES NOT EXIST, ERASE NOT 


DONE 


Explanation: The erase requested was not performed. The 
employee number requested was not present in the table. 


| Internal DB2 Information > el 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


eee eee End of Internal DB2 Information eetsie ats 


System Action: No employee data is erased. 


User Response: Determine if the employee data to be erased 
should exist. Verify that the correct search criteria and data 
were entered. If appropriate, correct the entries and continue 
processing. 


Problem Determination: List the contents of the employee 
view, VEMP, and the department view, VDEPT. 
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DSN8007E — DSN8015E 


DSN8007E _ csect EMPLOYEE DOES NOT EXIST, UPDATE NOT 


DONE 


Explanation: The update requested was not performed. The 
employee number requested was not present in the table. 


Internal DB2 Information os oe a 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8BP3 DSN8CP3 DSN8IP3 
DSN8MCF DSN8MCG DSN8MDG 
DSN8MPF DSN8MPG 


oes tee ea End of Internal DB2 Information eee | 


System Action: No employee data is updated. 


User Response: Verify that the correct search criteria and data 
were entered. 


Problem Determination: List the contents of the employee 
table (VPHONE, VEMPLP, or EMP) and see if the employee 
number to be updated is in the table. Correct the update 
request or the table. 


DSN8008! csect NO EMPLOYEE FOUND IN TABLE 


Explanation: No employees match the selection criteria. 


| ’ Internal DB2 information ~————S— aa 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8BP3 DSN8CP3 DSN8IP3 
DSN8MCG DSN8MDG DSN8MPG 


eta tee gee End of Internal DB2 Information eee | 


System Action: No employee data is listed. 


User Response: If no employee data was expected, continue 
processing. 


Problem Determination: List the contents of the VPHONE view 
and the underlying tabies. 


DSN80111 csect DEPARTMENT NOT FOUND 


Explanation: No departments match the selection criteria. 


| Internal DB2 Information Soe or 7s] 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


ee End of internal DB2 Information | 


System Action: No departments are listed. 


User Response: If no departments are expected to be found, 
continue. 


Problem Determination: _ If the error is unexpected, list the 
contents of the department views VDEPT and VDEPMG1 and 
their underlying tables to determine why the entry is missing. 
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DSN80121 csect DEPARTMENT SUCCESSFULLY ADDED 


Explanation: A department was added as requested. 


[ aaa Internal DB2 Information ~—— i 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


| _sEnd of Internal DB2 Information 


System Action: The request was executed successfully. 


DSN80131 csect DEPARTMENT SUCCESSFULLY ERASED 


Explanation: Data for a department was erased as requested. 


| Internal DB2 Information aaa ie 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


Ns eos End of Internal DB2 Information see 


System Action: The request was executed successfully. 


DSN8014I csect DEPARTMENT SUCCESSFULLY UPDATED 


Explanation: Data for a department was updated as requested. 


a5 a 7 Internal DB2 Information ~~ aa | 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


{SS _seEnd of Internal DB2 Information ____———_| 


System Action: The request was executed successfully. 


DSN8015E  csect DEPARTMENT EXISTS ALREADY, ADD NOT 


DONE 


Explanation: You requested that a new department be added, 
but the department exists already. 


~~ Internal DB2 Information == 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


Ogee ee End of internal DB2 Information pA eee 


System Action: No departments are added. 


User Response: Display data for the existing department. If it 
is what you want, continue. If not, you can update data for this 
department or choose a new department id. 


Problem Determination: If the error is unexpected, list the 
contents of the department views VDEPT and VDEPMG1 and 
their underlying tables to see if the data differs from what is 
expected. 


DSN8016E csect DEPARTMENT DOES NOT EXIST, ERASE 


NOT DONE 


Explanation: The erase request found no departments which 
match your request. 


[ a Fae Internal DB2 information 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


————s End of Internal DB2 Information peel 


System Action: No department data is erased. 


User Response: See if the department data to be erased 
should exist. Did you enter the correct combination of search 
criteria and data? If not, correct the entries and continue. 


Problem Determination: {f the error is unexpected, list the 
contents of the department views VDEPT and VDEPMG1 and 
their underlying tables to determine why the entry is missing. 


DSN8017E  csect DEPARTMENT DOES NOT EXIST, UPDATE 


NOT DONE 


Explanation: The update request found no department data 
which matches your request. 


=> Internal DB2 Information ~~~ | 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


ee End of Internal DB2 Information Sena ll 


System Action: No department data is updated. 


User Response: See if the department data to be updated 
should exist. !f you did not enter the correct combination of 
search criteria and data, correct the entries and continue. 


Problem Determination: _ If the error is unexpected, list the 
contents of the department views VDEPT and VDEPMG1 and 
their underlying tables to determine why the entry is missing. 


DSN8018I csect 'CURRENT' DEPARTMENT NOT FOUND 


Explanation: A request was made by a ‘current' department to 
reference a 'higher' department. The 'current' department 
was not found. 


| 7 ; Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSN8MCD DSN8MCG DSN8MPD 
DSN8MPG DSN8MPT 


na End of Internal DB2 Information eB ees 


System Action: No department data is processed. 


User Response: Ifthe ‘current' department was not expected 
to exist, continue processing. 


Problem Determination: List the contents of the department 
views VDEPMG1, VEMP, VASTRDE1, and VASTRDE2 and their 
underlying tables. 


DSN8016E — DSN80231 


DSN8019E_ csect NO 'HIGHER' DEPARTMENT EXISTS 


Explanation: A request was made by a 'current' department to 
reference a 'higher' level of the department structure. A 
"higher' level does not exist for the requested 'current' 
department. 


[ — fnternal DB2 Information Bee 


This message is issued by the following CSECT(s): 


DSN8MCD DSN8MCG DSN8MPD 
DSN8MPG DSN8MPT 


Ls End of Internal DB2 Information _____———_| 


System Action: No department data is processed. 


User Response: lf a 'higher' department was not expected to 
be found, continue processing. 


Problem Determination: List the contents of the department 
views VDEPMG1, VEMP, VASTRDE1, and VASTRDE2 and their 
underlying tables. 


DSN80211_ ~=csect ACTIVITY NOT FOUND 


Explanation: No activities match the selection criteria. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


[eae inm eo End of Internal DB2 Information ei ots ts 


System Action: No activity is listed. 


User Response: If no activity was expected to be found, con- 
tinue processing. 


Problem Determination: List the contents of the activity views 
VPROJRE1, VACT, and VPROJACT and their underlying tables. 


DSN8022! csect ACTIVITY SUCCESSFULLY ADDED 


Explanation: An activity was added as requested. 


F i —~ {nternal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


Uh a5 ease End of Internal DB2 Information ees | 


System Action: The request was executed successfully. 


DSN80231_ _—scsect ACTIVITY SUCCESSFULLY ERASED 


Explanation: An activity was erased as requested. 


b ~~~ Internal DB2 Information 7 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


Lee eee a End of Internal DB2 Information eres 
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DSN8024!1 — DSN8032!I 


System Action: The request was executed successfully. 


DSN80241 csect ACTIVITY SUCCESSFULLY UPDATED 


Explanation: An activity was updated as requested. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


le es, End of internal DB2 Information eee 


System Action: The request was executed successfully. 


DSN8025E__—scsect ACTIVITY EXISTS ALREADY, ADD NOT 


DONE 


Explanation: The addition requested was not performed. The 
activity requested was already present. 


Le = Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


eh ete End of Internal DB2 Information oe et 


System Action: No activity is added. 


User Response: If the activity was expected to already exist, 
continue processing. 


Problem Determination: List the contents of the activity views 
VPROJRE1, VACT, and VPROJACT and their underlying tables. 


DSN8026E _csect ACTIVITY DOES NOT EXIST, ERASE NOT 


DONE 


Explanation: The erase requested was not performed. The 
activity requested was not found. 


Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


| Ss End of internal DB2 information 


System Action: No activity is erased. 


User Response: Ifthe activity was not expected to be found, 
continue processing. 


Problem Determination: List the contents of the activity views 
VPROJRE1, VACT, and VPROJACT and their underlying tables. 


DSN8027E_ _—s csect ACTIVITY DOES NOT EXIST, UPDATE NOT 


DONE 


Explanation: The update requested was not performed. The 
activity requested was not found. 
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” Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


a End of Internal DB2 Information eee 


System Action: No activity is updated. 


User Response: Determine if the activity to be updated should 
exist. Verify that the correct search criteria and data were 
entered. If appropriate, correct the entries and continue proc- 
essing. 


Problem Determination: List the contents of the activity views 
VPROJRE1, VACT, and VPROJACT and their underlying tables. 


DSN8028!_ _—scsect ACTIVITY TYPE NOT FOUND, PLEASE ADD 


IT INTERACTIVELY 


Explanation: The add or update was not performed. The 
activity type entered was not found. 


ae ~~ ~_ Internal DB2 Information 7 | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW, DSN8MPX 


Woe eae End of Internal DB2 Information Pe 


System Action: No activity is listed. 


User Response: If the activity type was not expected to be 
found, add it interactively. 


Problem Determination: List the contents of the activity view, 
VACT, and its underlying tables. 


DSN8031! csect PROJECT NOT FOUND 


Explanation: No projects match the selection criteria. 


jee ~ Internal DB2 Information a ae | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


ee End of Internal DB2 Information oie eset ee 


System Action: No projects are listed. 


User Response: If no projects are expected to be listed, con- 
tinue. 


Problem Determination: Ifthe error is unexpected, list the con- 
tents of the project view VPROJ and its underlying tables to 
determine why the entry is missing. 


DSN8032I csect PROJECT SUCCESSFULLY ADDED 


Explanation: A project was added as requested. 


Pe internal DB2 Information ~ | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


[eee End of Internal DB2 Information ie eae 


System Action: The request was executed successfully. 


DSN80331 csect PROJECT SUCCESSFULLY ERASED. 


Explanation: A project was erased as requested. 


| internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


Ye esc ane oe End of Internal DB2 Information ees 


System Action: The request was executed successfully. 


DSN8034! csect PROJECT SUCCESSFULLY UPDATED 


Explanation: The update was performed as requested. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


Ne eee es End of Internal DB2 Information eto toe ett 


System Action: The request was executed successfully. 


DSN8035E csect PROJECT EXISTS ALREADY, ADD NOT 


DONE 


Explanation: You requested that a new project be added, but 
the project exists already. 


[ Internal DB2 information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


aes End of Internal DB2 Information ee 


System Action: The request was not executed successfully. 


User Response: Display the existing project. If it is what you 
want, continue. If not, you can update this project or choose a 
new project id. 


Problem Determination: If the error was unexpected, list the 
contents of the project view VPROJ and its underlying tables to 
see if the data differs from what is expected. 


DSN8036E csect PROJECT DOES NOT EXIST, ERASE NOT 


DONE 


Explanation: The erase request found no project which 
matches your request. 


| Internal DB2 Information —— = | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


De Meewen oes End of Internal DB2 Information ee || 


System Action: No projects are erased. 


DSN80331 — DSN8039E 


User Response: See if the project to be erased should exist. 
Did you enter the correct combination of search criteria and 
data? If not, correct the entries and continue. 


Problem Determination: If the error was unexpected, list the 
contents of the project view VPROJ and its underlying tables to 
determine why the entry is missing. 


DSN8037E csect PROJECT DOES NOT EXIST, UPDATE NOT 


DONE 


Explanation: The update request found no project which 
matches your request. 


[ Internal DB2 information ; | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


Us ge eet End of Internal DB2 information =| 


System Action: No projects are updated. 


User Response: See if the project to be updated should exist. 
If you did not enter the correct combination of search criteria 
and data, correct the entries and continue. 


Problem Determination: lf the error is unexpected, list the con- 
tents of the project view VPROJ and its underlying tables to 
determine why the entry is missing. 


DSN8038! csect 'CURRENT' PROJECT NOT FOUND 


Explanation: A request was made by a 'current' project to ref- 
erence a 'higher' project. The 'current' project was not found. 


[ Internal DB2 information ~~ | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPT, DSN8MPV 


Hee eee End of Internal DB2 Information Beg tte 


System Action: No project data is processed. 


User Response: Ifthe 'current' project was not expected to be 
found, continue processing. 


Problem Determination: List the contents of the project views 
VPROJRE1, VDEPT, VEMPPROJACT, VEMP, VSTAFAC1, 
VSTAFAC2, VPSTRDE1, and VPSTRDE2 and their underlying 
tables. 


DSN8039E_ _ csect NO 'HIGHER' PROJECT EXISTS 


Explanation: A request was made by a ‘current’ project to ref- 
erence a 'higher' level of the project structure. A 'higher' 
level does not exist for the requested 'current' project. 


internal DB2 Information ~e e =i] 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8SMPV 


Ne esos End of Internal DB2 Information ft | 


System Action: No project data is processed. 


User Response: Ifa 'higher' project was not expected to be 
found, continue processing. 
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DSN80411 — DSN8047E 


Problem Determination: List the contents of the project views 
VPROJRE1, VDEPT, VEMPPROJACT, VEMP, VSTAFAC1, 
VSTAFAC2, VPSTRDE1, and VPSTRDE2 and their underlying 
tables. 


DSN80411 csect STAFFING NOT FOUND 


Explanation: No project staffing matches the selection criteria. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


(ee ee End of Internal DB2 Information pee 


System Action: No project staffing is listed. 


User Response: |f no project staffing was expected to be 
found, continue processing. 


Problem Determination: List the contents of the project activity 
views VPROJRE1, VEMPPROJACT, VACT, and VEMP and their 
underlying tabies. 


DSN8042I csect STAFFING SUCCESSFULLY ADDED 


Explanation: A project staffing was added as requested. 


| Internal DB2 Information ~ “| 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


eos = es End of Internal DB2 Information | 


System Action: The request was executed successfully. 


DSN80431 csect STAFFING SUCCESSFULLY ERASED 


Explanation: A project staffing was erased as requested. 


[ ~~ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPW, 
DSN8MPG 


a nee End of Internal DB2 Information _ id 


System Action: The request was executed successfully. 


DSN8044I csect STAFFING SUCCESSFULLY UPDATED 


Explanation: A project staffing was updated as requested. 


[ Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


[ee ee End of Internal DB2 Information ee: 


System Action: The request was executed successfully. 
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DSN8045E = csect STAFFING EXISTS ALREADY, ADD NOT 


DONE 


Explanation: A request was made to add a project staffing, but 
the project staffing already exists. 


[ 5 Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


[snd of internal DB2 Information _____———_—i 


System Action: No project staffing is added. 


User Response: Display the existing project staffing. If this is 
the desired project staffing, update it. Otherwise, choose a new 
project staffing. 


Problem Determination: List the contents of the project activity 
views VPROJRE1, VEMPPROJACT, VACT, and VEMP and their 
underlying tabies. 


DSN8046E _ csect STAFFING DOES NOT EXIST, ERASE NOT 


DONE 


Explanation: The project staffing was not erased as requested. 


a ee Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


[ss End of Internal DB2 Information ___————_| 


System Action: No project staffing is erased. 


User Response: Determine if the project staffing to be erased 
should exist. Verify that the correct search criteria and data 
were entered. If appropriate, correct the entries and continue 
processing. 


Problem Determination: List the contents of the project activity 
views VPROJRE1, VEMPPROJACT, VACT, and VEMP and their 
underlying tables. 


DSN8047E_ _—scsect STAFFING DOES NOT EXIST, UPDATE NOT 


DONE 


Explanation: The update was not performed because the 
project staffing requested was not found. 


i. = ~ Internal DB2 Information : | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


te eee es End of Internal DB2 Information ee 


System Action: No project staffing is updated. 


User Response: Determine if the project staffing to be updated 
should exist. Verify that the correct search criteria and data 
were entered. If appropriate, correct the entries and continue 
processing. 


Problem Determination: List the contents of the project activity 
views VPROJRE1, VEMPPROJACT, VACT, and. VEMP and their — 
underlying tables. 


DSN80511 csect PROGRAM ENDED 


Explanation: The application program finished. 


a ~~ Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSN8BF3 DSN8MC1 DSN8MCG 
DSN8MPG DSN8MP1 


{snd of Internal DB2 Information == 


DSN8053I1 csect ROLLBACK SUCCESSFUL, ALL UPDATES 


REMOVED 


Explanation: After any SQLWARNING or SQLERROR, all 
updates are removed via a ROLLBACK statement to prevent 
invalid updates. 


a —————~_ Internal DB2 Information | 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8BP3 DSN8MCG DSN8MDG 
DSN8MPG 


Dee ast et End of Internal DB2 Information ete ae 


System Action: The ROLLBACK was executed successfully. 


User Response: Correct the prior error. 


DSN80561 #csect NO MORE DATA TO DISPLAY 


Explanation: The last page of data has been displayed. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSN8MCD DSN8MCG DSN8MPG 
DSN8MPD DSN8MPT DSN8MPV 


a es End of Internal DB2 Information peek 


System Action: No more data is shown on screen. 


User Response: If you expect no more data to be displayed, 
continue. 


Problem Determination: |f more displayed data is expected, 
list the contents of the view and the underlying tables to see if 
the data differs from what is expected. 


DSN80571 csect FURTHER ENTRIES IN TABLE - UPDATE 


POSSIBLE 


Explanation: More data exists beyond that shown on the 
screen. 


[ — Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): DSN8CP3, 
DSN8MPG 


oer End of Internal DB2 Information ei Raisin on Sl 


DSN80511 — DSN8061E 


System Action: No more data is shown on screen. 


User Response: update entries as needed. 


DSN8058I csect PRESS PA1 FOR NEXT PAGE / ENTER FOR 


SELECTION MENU 


Expianation: Press the PA1 key to see the data on the next 
page or press the ENTER key to return to the selection menu. 


Internal DB2 Information = | 


This message is issued by the following CSECT(s): DSN8IP3, 
DSN8MPG 


[eee ater tae End of Internal DB2 Information | 


User Response: Press the PA1 key or the ENTER key 
depending on the function you want to perform. 


DSN8060E _ _ csect SQL ERROR, RETURN CODE IS: sqicode 


Explanation: The SQL statement did not execute correctly. 
The 'sqicode' can be found elsewhere in this manual. This 
may be an SQL ERROR or an SQL warning. 


[ =: Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8CP3 DSN8IP3 DSN8MCG 
DSN8MDG DSN8MPG 


———d End of internal DB2 !nformation ae 


System Action: The request was not executed successfully. 


User Response: Refer to “Section 2. SQL Return Codes” on 
page 2-1 for more information about the error. 


Problem Determination: Determine which SQL statement in the 
application program caused the error and see if it is reproduc- 
ible. Follow the diagnosis approach suggested for the sqicode. 


DSN8061E  csect ROLLBACK FAILED, RETURN CODE IS: 


sqicode 


Explanation: The SQL ROLLBACK statement was not executed 
correctly. 


| ~ Internal DB2 information ~~ | 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8BP3 DSN8MCG DSN8MDG 
DSN8MPG 


eee End of Internal DB2 Information ett sel 


System Action: The request was not executed successfully. 
User Response: Refer to “Section 2. SQL Return Codes” on 
page 2-1. 


Problem Determination: Determine which SQL statement in the 
application program caused the error and see if it is reproduc- 
ible. Follow the diagnosis approach suggested for the sqicode. 
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DSN8062E — DSN8069E 


DSN8062E _ _csect AN OBJECT WAS NOT SELECTED 


Explanation: You did not specify an object code on the input 
line. 


| Internal DB2 Information ~ 1 


This message is issued by the following CSECT(s): 


DSN8CC2 DSN8CP2. DSN8CP8 
DSNB8IC2 DSNBIP2 DSNBIP8 
DSN8MCG DSN8MPG 


ae End of Internal DB2 Information ee ee 


System Action: None. 


User Response: Select one of the object codes listed on the 
panel. 


DSN8064E . csect INVALID DL/I STC-CODE ON GU MSG: 
status-code 


Explanation: In attempting to get a message from IMS, an 
unexpected status-code was received. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSN8ICO DSN8IPO DSN8IP3 
DSN8IP6 DSN8MCG DSN8MPG 


po End of Internal DB2 Information ates 


System Action: The application program is terminated. 


Problem Determination: Refer to the messages and codes 
manual for IMS/VS to determine the reason for the unexpected 
status code. 


DSN8065E __—scsect INVALID DL/I STC-CODE ON ISRT MSG: 
status-code 


Explanation: In attempting to insert a message for IMS, an 
unexpected status-code was received. 


[ - Internal DB2 Information aes | 


This message is issued by the following CSECT(s): 


DSN8ICO DSN8IPO DSN8IP3 
DSN8IP6 DSN8MCG DSN8MPG 


cee End of Internal DB2 Information eee 


System Action: The application program is terminated. 


Problem Determination: Refer to the messages and codes 
manual for IMS/VS to determine the reason for the unexpected 
status code. 


DSN8066E csect UNSUPPORTED PFK OR LOGIC ERROR 


Explanation: The sample application found an unsupported 
program function key or logic error while trying to execute a 
request. 
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a = Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): 


DSN8CC2 DSN8CP2 DSN8CP8 
DSN8IC2 DSN8IP2 DSNS8iIP8 
DSN8MCD DSN8MCG DSN8MPD 
DSN8MPG DSN8MPT DSN8MPV 


aos End of Internal DB2 information ee 


System Action: The request was not executed successfully. 


User Response: Report the error in the application program. 


DSN8067E csect UNSUPPORTED SEARCH CRITERIA FOR 
OBJECT 


Explanation: You entered a search criteria value and an object 
value that do not find any selections. 


— Internal DB2 Information ~~ = 


This message is issued by the following CSECT(s): 


DSN8IC2 DSN8MCA DSN8MCG, 
DSN8MPA DSN8MPG DSN8MPM 


De ee End of internal DB2 information fees | 


System Action: The request was not executed successfully. 
User Response: Enter new search criteria values. 


Problem Determination: If the values you entered are expected 
to provide valid selections, check the contents of the view and 
the underlying tables to see if the data differs from what is 
expected. If after checking the view and the underlying tables, 
you find the search criteria values you entered should provide 
valid selections, the error is in the sample program. Report the 
error. 


DSN8068E_ _csect INVALID REQUEST SHOULD BE 'L' OR 'U' 


Explanation: The input must begin with L or U. 


t~ Internal DB2 Information Oe 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8BP3 DSN8MCG DSN8MDG 
DSN8MPG 


arn oer eee End of Internal DB2 Information Pos eae 


System Action: The request is ignored. 


User Response: Correct the input request. 


DSN8069E_ _ csect NO VALID SELECTIONS QUALIFY FOR THIS 
REQUEST 


Explanation: You entered a search criteria value and a data 
values that do not find any selections. 


aa ~~ Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSN8MCA DSN8MCE DSN8MCF 
DSN8MCG DSN8MPA DSN8MPE 
DSN8MPF DSN8MPG DSN8MPM 
DSN8MPW DSN8MPX DSN8MPZ 


lee eee End of Internal DB2 Information 6 


System Action: The request was not executed successfully. 
User Response: Enter new search criteria values. 


Problem Determination: Ifthe criteria values you entered are 
expected to provide valid selections, check the contents of the 
view and the underlying tables to see if the data differs from 
what is expected. If after checking the view and the underlying 
tables, you find the search criteria values you entered should 
provide valid selections, the error is in the sample program. 
Report the error. 


DSN8070E _—scsect VITAL DATA IS MISSING IN TABLE 


"TOPTVAL' 


Explanation: No valid entries exist in the table that contains 
possible valid entries. 


| Internal DB2 Information a sd 


This message is issued by the following CSECT(s): 


DSN8MCD DSN8MCG DSN8MC3 

DSN8MC4 DSN8MC5 DSN8MPA 
DSN8MPD DSN8MPG DSN8MPM 
DSN8MPT DSN8MPV DSN8MP3 

DSN8MP4 DSN8MP5 


Hi gates atone End of Internal DB2 Information eee) 


System Action: The request was not executed successfully. 


User Response: There is no valid entry you can enter. Report 
the error in the sample program. 


DSN8072E _csect INVALID SELECTION ON SECONDARY 


SCREEN 


Explanation: You gave an invalid line number. 


| Internal DB2 Information 


This message is issued by the following CSECT(s): 


DSN8CC2 DSN8CP2 DSN8CP8 
DSN8IC2 DSN8IP2 DSN8IP8 
DSN8MCG DSN8MPG 


rer End of Internal DB2 Information _ 


System Action: The request was not executed successfully. 


User Response: You entered a number that is not in the list on 
the left under the heading NO for line number. Enter a valid 
number. 


Problem Determination: If the line number you entered is in 
the list on the left under the heading NO for line number, then 
the error is in the sample program. 


DSN8070E — DSN8076E 


DSN8073E_ _csect SPECIFIED LINE-NUMBER NOT FOUND IN 


PREVIOUS SCREEN 


Explanation: You gave an invalid line number. 


Internal DB2 information | 


This message is issued by the following CSECT(s): 


DSN8MCD DSN8MCG DSN8MPD 
DSN8MPG DSN8MPT DSN8MPV 


a End of Internal DB2 Information pee te 


System Action: The request was not executed successfully. 


User Response: You entered a number that is not in the list on 
the left under the heading NO for line number. Enter a valid 
number. If the line number is in the previous screen, then this 
is an error in the sample program. Report the error. 


DSN8074E = csect DATA IS TOO LONG FOR SEARCH CRITERIA 


Explanation: You entered a data value that has too many char- 
acters for the type of search criterion you selected. For 
example, department ids have a maximum of 3 characters and 
most other ids have a maximum of 6 characters. 


= —— Internal DB2 Information _ ee 


This message is issued by the following CSECT(s): 


DSN8MCA DSN8MCG DSN8MPA 
DSN8MPG DSN8MPM 


Vee ee End of Internal DB2 Information eee) 


System Action: The request was not executed successfully. 


User Response: Enter a data value with the correct number of 
characters. 


DSN8075E csect MESSAGE FORMAT ROUTINE ERROR, 


RETURN CODE IS: sqicode 


Explanation: There is an error in the parameters passed to the 
SQLCA formatting routine, DSNTIAR. 


| — Internal DB2 Information ~~ | 


This message is issued by the following CSECT(s): 


DSN8BC3 DSN8BD3 DSN8BF3 
DSN8BP3 DSN8MCG DSN8MDG 
DSN8MPG 


Peat Sec ot End of Internal DB2 Information eos cl 


System Action: The SQLCA could not be formatted properly. 


User Response: This is an error in the program. Check the 
return code listing of DSNTIAR in this manual. Report the error. 


DSN8076E = csect VITAL DATA IS MISSING IN TABLE 


*TDSPTXT' 


Explanation: No valid entries exist in the tabie that contains 
possible valid entries. 


DB2 Messages 3-295 


DSN8080E — DSN8202E 


| Internal DB2 Information © rer 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPM 


ere End of Internal DB2 Information ene 


System Action: The request was not executed successfully. 


User Response: There is no valid entry you can enter. Report 
the error in the application program. 


DSN8080E APPLICATION TERMINATED WITH CALL ATTACH 


REASON CODE reason-code 


Explanation: The call attachment facility service requested by 
the application program did not execute successfully. 


— Speen Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8SCM, 
DSN8SPM 


ee re End of Internal DB2 Information Det cot a fe 


System Action: The requested service is not executed. 
User Response: Notify the system programmer. 


System Programmer Response: Check the cail attachment 
facility reason code. 


Problem Determination: Follow the failure analysis procedures 
for the call attachment facility reason code. 


DSN8081E RESULTS FROM THE CALL ATTACH TRANSLATE 


SERVICE 


Explanation: The call attachment facility OPEN service that 
was requested from the application program did not execute 
successfully. The TRANSLATE service was requested to 
provide information about the OPEN failure. 


| Internal DB2 Information ~~ ———~<~«7 i 


This message is issued by the following CSECT(s): DSN8SCM, 
DSN8SPM 


eee ee End of Internal DB2 Information Sone aaa 


System Action: The requested OPEN service was not executed. 


User Response: Refer to “Section 2. SQL Return Codes” on 
page 2-1. 


Problem Determination: Refer to “Section 2. SQL Return 
Codes” on page 2-1 for more information about the error. 


DSN8082E THE DISCONNECT TERMINATED WITH REASON 
CODE reason-code 


Explanation: The cail attachment facility DISCONNECT service 
requested by the application program did not execute success- 
fully. 
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| Internal DB2 Information Sa 


This message is issued by the following CSECT(s): DSN8SCM, 
DSN8SPM 


a End of Internal DB2 Information eee eee 


System Action: The requested DISCONNECT service is not 
executed. 


User Response: Notify the system programmer. 


System Programmer Response: Check the call attachment 
facility reason code. 


Problem Determination: Follow the failure analysis procedures 
for the call attachment facility reason code. 


DSN8083E AN UNKNOWN SERVICE service WAS 


REQUESTED 


Explanation: The user is requesting an invalid service. 


il ‘> Internal DB2 Information = | 


This message is issued by the following CSECT(s): DSN8SCM, 
DSN8SPM 


Re ee End of internal DB2 Information | 


System Action: The requested service was not executed. 
User Response: Notify the system programmer. 


System Programmer Response: The service request must be a 
valid call attachment facility service. Ensure that the request is 
one of the services supported by the call attachment facility. 


Problem Determination: There is an error in the Sample Appli- 
cation Program. 


DSN8200E  csect INVALID DEPARTMENT NUMBER, 


EMPLOYEE NOT ADDED 


Explanation: The employee number that is to be added refers 
to a department number that is not contained in the table DEPT. 


| Internal DB2 Information > ~ | 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


ee ee End of internal DB2 Information eee | 


System Action: The employee number is not added. 


User Response: Ensure that the correct department number 
was entered. 


Problem Determination: List the contents of the department 
table DEPT. 


DSN8202E csect EMPLOYEE NUMBER HAS DEPENDENT 


ROWS, NOT ERASED 


Explanation: The employee number to be erased is the same 
as a responsible employee number in the table PROJ or an 
employee number in the table EMPPROJACT. The employee 
number cannot be erased from the table EMP. 


[ ~~~ _ Internal DB2 information ~~ il 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


ee End of Internal DB2 Information ee eee 


System Action: No employee data is erased. 


User Response: Ensure that the correct employee number was 
entered. 


Problem Determination: List the contents of the PROJ and 
EMPPROJACT tables. 


DSN8203E_ _csect INVALID WORK DEPT, EMPLOYEE NOT 


UPDATED 


Explanation: The employee that is to be updated has a depart- 
ment number that is not contained in the table DEPT. The 
update cannot be completed. 


| ~— {Internal DB2 Information a ol 


This message is issued by the following CSECT(s): DSN8MCF, 
DSN8MCG, DSN8MPF, DSN8MPG 


Date tes End of Internal DB2 Information ee ete 


System Action: No employee data is updated. 


User Response: Ensure that the correct department number 
was entered. 


Problem Determination: List the contents of the employee 
table DEPT. 


csect INVALID MGRNO, DEPARTMENT NOT 
ADDED 


Explanation: The department that is to be added has a 
manager number that is not contained in the table EMP. The 
add cannot be completed. 


DSN82101 


7S —-“\. == Internal DB2 Information ~~ 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


Peete eae, End of Internal DB2 Information Sea ee 


System Action: No department is added. 


User Response: Ensure that the correct manager number was 
entered. 


Problem Determination: List the contents of the employee 
table EMP. 


DSN8212E csect DEPARTMENT NUMBER HAS DEPENDENT 


ROWS, NOT ERASED 


Explanation: The department number that is to be erased is 
the same as a project department number in table PROJ. The 
department cannot be erased. 


DSN8203E — DSN8215E 


| - Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


[eo es End of Internal DB2 Information Se Pee ese 


System Action: No department data is erased. 


User Response: Ensure that the correct department number 
was entered. 


Problem Determination: List the contents of the project table 
PROJ. 


DSN8213E  csect INVALID ADMIN DEPT ID, DEPARTMENT 


NOT ADDED 


Explanation: The department that is to be added has a depart- 
ment number that is not contained in the table DEPT. The add 
cannot be completed. 


| Internal DB2 Information | 


This message is issued by the folowing CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


a End of Interna! DB2 Information Bea Ss 


System Action: No department is added. 


User Response: Ensure that the correct department number 
was entered. 


Probtem Determination: List the contents of the employee 
table DEPT. 


DSN8214E _csect INVALID MANAGER ID, DEPARTMENT NOT 


UPDATED 


Explanation: The department that is to be updated has a 
manager number that is not contained in the table EMP. The 
update cannot be completed. 


= internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


Pe End of Internal DB2 Information _ id 


System Action: No department data is updated. 


User Response: Ensure that the correct manager number was 
entered. 


Problem Determination: List the contents of the employee 
table EMP. 


DSN8215E  csect INVALID ADMIN DEPT ID, DEPARTMENT 


NOT UPDATED 


Explanation: The department that is to be updated has a 
administrative department number that is not in the table DEPT. 
The update cannot be completed. 
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DSN8220E — DSN8233E 


| Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MCE, 
DSN8MCG, DSN8MPE, DSN8MPG 


(eset eens See End of Internal DB2 Information oie 


System Action: No department data is updated. 


User Response: Ensure that the correct department number 
was entered. 


Problem Determination: List the contents of the employee 
table DEPT. 


DSN8220E__—scsect INVALID PROJECT NUMBER, ACTIVITY NOT 


ADDED 


Explanation: The activity that is to be added contains a project 
number that is not contained in the table PROJ. The add cannot 
be completed. 


— laine wt Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


ae aera End of Internal DB2 Information po he 


System Action: The activity is not added. 


.User Response: Ensure that the correct project number was 
entered. 


Problem Determination: List the contents of the project table 
PROJ. 


DSN8222E_—scsectt ACTIVITY HAS DEPENDENT ROWS, NOT 


ERASED 


Explanation: The activity that is to be erased from table 
PROJACT is the same as the corresponding activity in the table 
EMPPROJACT. The activity cannot be erased from the table 
PROJACT. 


ee Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


WS Sao eet) End of Internal DB2 Information eo | 


System Action: No activity data is erased. 
User Response: Ensure that the correct activity was entered. 


Problem Determination: List the contents of the PROJACT and 
EMPPROJACT tables. 


DSN8223E _csect ACTIVITY HAS DEPENDENT ROWS, NOT 


UPDATED 


Explanation: A start date in table PROJACT is to be updated, 
but there is a project staffing for this activity in table 
EMPPROJACT. The start date in table PROJACT cannot be 
updated. 


3-298 DB2 Messages and Codes 


ee Internal DB2 Information ~_ _ a | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPX 


Ce End of Internal DB2 Information et) 


System Action: No activity data is updated. 


User Response: Ensure that the correct start date was 
entered. 


Problem Determination: List the contents of the project- 
activity-staffing table EMPPROJACT and project-activity table 
PROJACT. 


DSN8230E__—scsect INVALID DEPARTMENT NUMBER, PROJECT 


NOT ADDED 


Explanation: The project that is to be added contains a depart- 
ment number that is not present in the table DEPT. The add 
cannot be completed. 


a ~~~ _ Internal DB2 Information ~~ 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


sea End of Internal DB2 Information Deere: 


System Action: No project is added. 


User Response: Ensure that the correct department number 
was entered. 


Problem Determination: List the contents of the department 
table DEPT. 


DSN8231E  csect INVALID RESPONSIBLE ID, PROJECT NOT 


ADDED 


Explanation: The project that is to be added contains an 
employee number that is not contained in the table EMP. The 
add cannot be completed. 


‘a — Internal DB2 Information : = 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


[bee ee End of Internal DB2 Information fee eee tes 


System Action: No project is added. 


User Response: Ensure that the correct employee number was 
entered. 


Problem Determination: List the contents of the employee 
table EMP. 


DSN8233E csect PROJECT NUMBER HAS DEPENDENT 


ROWS, NOT ERASED 


Explanation: A project number in table PROJ is to be erased, 
but it is the same as a project number in table PROJACT. The 
project cannot be erased from table PROJ. 


[ ” . : Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


[Le End of Internal DB2 Information ota eed 


System Action: No project is erased. 


User Response: Ensure that correct project number was 
entered. 


Problem Determination: List the contents of the PROJ and 
PROJACT tables. 


DSN8235E _ csect INVALID MAJOR PROJECT iD, PROJECT 


NOT ADDED 


Explanation: The project that is to be added contains a major 
project ID that is not contained in the table PROJ. The add 
cannot be completed. 


gee Fis internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


(agen Je ese End of Internal DB2 Information seen ti 


System Action: No project is added. 


User Response: Ensure that the correct major project number 
was entered. 


Problem Determination: List the contents of the project table 
PROJ. 


DSN8236E  csect INVALID ASSOCIATE DEPT ID, PROJECT 


NOT UPDATED 


Explanation: The project that is to be updated has a depart- 
ment number that is not contained in the table DEPT. The 
update cannot be completed. 


= Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


LT End of Internal DB2.information _ 


System Action: No project data is updated. 


User Response: Ensure that the correct department number 
was entered. 


Problem Determination: List the contents of the department 
table DEPT. 


DSN8237E _csect INVALID RESPONSIBLE ID, PROJECT NOT 


UPDATED 


Explanation: The project that is to be updated has a employee 
number that is not contained in the table EMP. The update 
cannot be completed. 


DSN8235E — DSN8242E 


[ raed a Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


a End of Interna! DB2 Information i 


System Action: No project data is updated. 


User Response: Ensure that the correct employee number was 
entered. 


Problem Determination: List the contents of the employee 
table EMP. 


DSN8238E_ _csect INVALID MAJOR PROJECT ID, PROJECT 


NOT UPDATED 


Explanation: The project that is to be updated has a major 
project number that is not contained in the table PROJ. The 
update cannot be completed. 


a ot ph Internal DB2 Information ” 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPZ 


Pesan End of Internal DB2 Information oat eae read 


System Action: No project data is updated. 


User Response: Ensure that the correct project number was 
entered. 


Problem Determination: List the contents of the project table 
PROJ. 


DSN8240E__—scsect INVALID EMPLOYEE NUMBER, STAFFING 


NOT ADDED 


Explanation: The staffing that is to be added refers to an 
employee number that is not present in table EMP. The add 
cannot be completed. 


‘a ~ Internal DB2 Information nae | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


fete End of Internal DB2 Information ee! 


System Action: No staffing is added. 


User Response: Ensure that the correct employee number was 
entered. 


Problem Determination: List the contents of employee table 
EMP. 


DSN8242E __—csect INVALID PROJECT ACTIVITY DATA, 


STAFFING NOT ADDED 


Explanation: The staffing that is to be added refers to a project 
number, activity number, and start date that is not present in 
table PROJACT. The add cannot be completed. 
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DSN8243E — DSN8243E 


AS = Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


eet eee End of Internal DB2 Information | 


System Action: No staffing is added. 


User Response: Ensure that the correct project number, 
activity number, and start date were entered. 


Problem Determination: List the contents of the project table 
PROJACT. 


DSN8243E _csect INVALID START DATE, STAFFING NOT 


UPDATED 


Explanation: The start date given is not currently in the 
project-activity table PROJACT. The update cannot be com- 
pleted. 
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Internal DB2 Information 


This message is issued by the following CSECT(s): DSN8MPG, 
DSN8MPW 


a End of Internal DB2 information ee es ok FH 


System Action: No staffing data is updated. 


User Response: Ensure that the correct start date was 
entered. 


Problem Determination: List the contents of the project-activity 
table PROJACT and the project-activity-staffing table 
EMPPROJACT. 


DSN90001 — DSN9005I 





General Command Processor Messages (DSNS&Q...) 


DSN90001 KEYWORD keyword-name APPEARS MORE THAN 


ONCE 


Explanation: The same keyword (specified in the messages as 
'keyword-name') appears more than once in the command. 
This message will be issued for each occurrence of the 
keyword after the first. 


ie ~ Internal DB2 Information ~ | 
This message is issued by the following CSECT(s): DSN9SCND 


Ae End of Internal DB2 Information eres 


System Action: Processing for the command is terminated. 


System Programmer Response: Correct the command by 
using the keyword only once, and reenter the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSN9001! KEYWORD keyword-name IS INVALID 


Explanation: The keyword (specified in the message as 
'keyword-name') is unknown or undefined. The keyword may 
be misspelled, or the keyword may not be applicable to the 
command being processed. 


[ao eres Internal DB2 Information oe ee eH 
This message is issued by the following CSECT(s): DSN9SCND 


rears End of Internal DB2 Information pe 


System Action: Processing for the command is terminated. 


System Programmer Response: Correct the keyword, and 
reissue the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSNS9002i UNBALANCED PARENTHESES WERE FOUND FOL- 


LOWING KEYWORD keyword-name 


Explanation: An invalid combination of parentheses has been 
encountered following the keyword (specified in the message 
as 'keyword-name'). Parenthesis must be paired open and 
close, and a close parenthesis must follow an open parenthesis 
before another open parenthesis is encountered. 


:— ~ Internal DB2 Information ~——— | 
This message is issued by the following CSECT(s): DSN9SCND 


————s End of Internal DB2 Information | 


System Action: Processing for the command is terminated. 


System Programmer Response: Correct the error, and reissue 
the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSNS90031 KEYWORD keyword-name PARAMETER CON- 


TAINS UNBALANCED APOSTROPHES 


Explanation: An odd number of apostrophes is present ina 
parameter. If the parameter is a quoted string, it must have 
one apostrophe at each end of the string. If an apostrophe is to 
appear within the string, two adjacent apostrophes must be 
entered. if the parameter is a hexadecimal value, it must be 
entered as X'hex characters'. 


a Internal DB2 Information ia | 
This message is issued by the following CSECT(s): DSNSSCND 


(ect ee End of Internal DB2 Information ete ees 


System Action: Processing for the command is terminated. 


System Programmer Response: Correct the error, and reissue 
the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSN9004! KEYWORD keyword-name RANGE (c) INCOR- 


RECTLY SPECIFIED 


Explanation: The range for a keyword (specified in the 
message as 'keyword-name') was incorrectly specified using 
the syntax character specified in the message as 'c'. The 
standard syntax character used to denote a range is a colon (:). 
Either the beginning or ending limit of the range was omitted. 


Examples of this error are LINE(1:) and NAME(:A). 


Examples of a correctly specified range are LINE(1:3) and 
NAME(C:N). 


CS = internal DB2 Information A 
This message is issued by the following CSECT(s): DSN9SCND 


ener ates End of Interna! DB2 Information te a 


System Action: Processing for the command is terminated. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference to verify that the command you 
are using allows a range for the given keyword. Correct the 
error, and reissue the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSN90051 KEYWORD keyword-name SUBSET (c) INCOR- 


RECTLY SPECIFIED 


Explanation: The subset for a keyword (specified in the 
message as 'keyword-name') was incorrectly specified for use 
with the syntax character 'c' in the message. The standard 
syntax character used to denote a subset is an asterisk (*). 


DB2 Messages 3-301 


DSN9006I — DSN9009! 


For example, consider a group of objects named BLACK, BLUE, 
GREEN, RED, and WHITE. You may either explicitly specify 
BLACK and BLUE, or you may specify BL*, meaning all 
members of the group whose names begin with BL. The char- 
acter that follows the asterisk must be a blank, comma, close 
parenthesis, or colon. 


Examples of such an error are NAME(BL*CK) and NAME(*LUE). 
Examples of correct specification are NAME(BL*) and UNIT(2"). 


internal DB2 Information ~— aes | 
This message is issued by the following CSECT(s): DSN9SCND 


[ia ek pee ote End of Internal DB2 Information po oie, | 


System Action: Processing for the command is terminated. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference to be sure that the command 
you are using allows a subset for the named keyword. Correct 
the error, and reissue the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSN9006I KEYWORD keyword-name ASTERISK (c) INCOR- 


RECTLY USED 


Explanation: For the keyword specified in the message (as 
‘keyword-name'), an asterisk (c) was used as the first char- 
acter of a parameter to specify ALL. However, the asterisk 
appears in a list, or the characters in juxtaposition are not a 
blank, comma, equal sign, or parentheses. 


Examples of such errors are LINE(LINE1,*,LINE7), NAME(**), 
and GROUP(PQR:”*). 


Examples of correct specification are UNIT(*) and LINE =* etc. 


[ ~~ Internal DB2 Information — : | 
This message is issued by the following CSECT(s): DSN9SCND 


as ae End of Internal DB2 Information S| 


System Action: Processing for the command is terminated. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference to be sure the command you 
are using allows specification of ALL for the given keyword. 
Correct the error, and reissue the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSN90071 EITHER KEYWORD name1 OR name2 MUST BE 


SPECIFIED 


Explanation: The command requires that either keyword 
‘name1' or keyword ‘name2' be specified, but neither keyword 
was entered on the command. One of the two keywords must 
be present in order for the command to be processed. 


3-302 DB2 Messages and Codes 


Internal DB2 Information ” 
This message is issued by the following CSECT(s): DSN9SSCND 


[ee eae a see End of Internal DB2 Information eee | 


System Action: Processing for the command is terminated. 


System Programmer Response: Reissue the command and 
include whichever keyword is appropriate. Refer to Chapter 2 
of Command and Utility Reference for descriptions of the two 
keywords. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSN9008! KEYWORD keyword-name MAY NOT BE NEGATED 


Explanation: The negation characters (NO) appear in front of 
the keyword (specified in the message as 'keyword-name'), 
but negating this keyword is not allowed. As an example, con- 
sider a keyword called PRINT that could indicate that you want 
something printed. If you did not want the material to be 
printed, you might specify NOPRINT. This process of prefixing a 
keyword with the characters NO is called negation. While 
negation may be meaningful on some keywords, it is not 
allowed on all keywords. 


ot ere internal DB2 Information oy 
This message is issued by the following CSECT(s): DSN9SSCND 


ee End of internal DB2 Information ee 


System Action: Processing for the command is terminated. 


System Programmer Response: Reenter the command, but do 
not negate the named keyword. Refer to Chapter 2 of 
Command and Utility Reference for further information con- 
cerning this command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSN9009! KEYWORD keyword-name IS MISSING AND MUST 


BE SPECIFIED 


Explanation: The keyword specified in the message (as 
'keyword-name') must be present, but it was not entered. This 
keyword must be present in order for the command to process 
properly. 


[ — Internal DB2 Information 
This message is issued by the following CSECT(s): DSN9SSCND 


fo, paep ences End of Internal DB2 Information ee | 


System Action: Processing for the command is terminated. 


System Programmer Response: Enter the command again, 
and include the specified keyword. 


Probiem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. — 


DSN90101 REQUIRED PARAMETER FOR KEYWORD 


keyword-name IS MISSING 


Explanation: A parameter must be specified for the keyword 
specified in the message (as 'keyword-name'), but no param- 
eter was entered. 


As an example of this error, consider a keyword called PRI- 
ORITY whose value can range from 0 to 9. Specification of 
PRIORITY(1) is acceptable, but, if you specify PRIORITY with no 
parameter value, the keyword is meaningless. 


; —— Internal DB2 Information aaa | 
This message is issued by the following CSECT(s): DSNSSCND 


Wee ce eee End of internal DB2 Information a: 


System Action: Processing for the command is terminated. 


System Programmer Response: Supply appropriate 
parameter(s) for the specified keyword, and reissue the 
command. Refer to Chapter 2 of Command and Utility Refer- 
ence for valid parameter values. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSNS011! PARAMETER(S) CANNOT BE SPECIFIED FOR 


KEYWORD keyword-name 


Explanation: No parameter(s) can be specified for the keyword 
specified in the message (as 'keyword-name'). You may have . 
misspelled the keyword-name, causing it to be interpreted as a 
different keyword, or the parameter may actually belong with 
another keyword instead of the one on which you entered it. 


| = " Internal DB2 Information | 
This message is issued by the following CSECT(s): DSNSSCND 


Dios seeSee at End of Internal DB2 Information et 


System Action: Processing for the command is terminated. 


System Programmer Response: Correct the error, and reissue 
the command. Refer to Chapter 2 of Command and Utility Ref- 
erence for details on how to enter the command. 


Problem Determination: Obtain a copy of the system or ter- 
’ minal log to verify the command entry. 


DSN90121 KEYWORD keyword-name PARAMETER(S) MUST 


BE HEXADECIMAL 


Explanation: Parameter values for the keyword specified in the 
message (as 'keyword-name') must be hexadecimal values. 
The value must be specified as X'hex characters’. 
Hexadecimal characters are defined as the numeric digits 0 
through 9 and the letters A through F. Either uppercase or low- 
ercase is acceptable for the letters A through F. 


As an example of this error, consider the keyword OFFSET, for 
which you are expected to enter a hexadecimal value. If you 
enter OFFSET(X'2C'), it is acceptable. However, entering 
OFFSET(Jones) is not acceptable. 


DSN9010!1 — DSN90141 


| Internal DB2 Information | 
This message is issued by the following CSECT(s): DSN9SCND 


[ee eee ok End of Internal DB2 Information era 


System Action: Processing for the command is terminated. 


System Programmer Response: Reissue the command, but 
ensure that the parameters for the named keyword are 
hexadecimal! values. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSN90131 KEYWORD keyword-name PARAMETER param- 


eter value EXCEEDS ALLOWABLE LENGTH OF nn 


Explanation: The parameter value (specified in the message 
as 'parameter value') exceeds the timit of 'nn' characters in 
length. 


As an example of this type of error, consider a PRIORITY 
keyword whose value may range from zero to nine. If you 
specify PRIORITY(21) or PRIORITY(006), the value you have 
entered exceeds the limit of one character. 


| Internal DB2 Information a f 
This message is issued by the following CSECT(s): DSN9SCND 


Ieee ak oe oes End of internal DB2 Information feces 


System Action: Processing for the command is terminated. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference for a list of acceptable parame- 
ters. Correct the error, and reissue the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSNS0141 KEYWORD keyword-name LIMIT OF nn 


PARAMETER(S) EXCEEDED 


Explanation: Too many parameters have been specified for the 
keyword that is specified in the message. The command 
processor does not accept more than the limit (specified in the 
message as '‘nn') of parameters. This error is probably caused 
by entering too many parameters. It could also be caused by a 
missing close parenthesis that has not yet been detected. 


| — Internal DB2 Information 3 eae 
This message is issued by the following CSECT(s): DSN9SCND 


ice as 9 End of Internal DB2 Information Se eae 


System Action: Processing for the command is terminated. 


System Programmer Response: Reissue the command, and 
enter no more than the specified limit of parameters for the 
given keyword. If necessary, issue the command more than 
once to process all the desired parameter values. Refer to 
Chapter 2 of Command and Utility Reference for further details. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DB2 Messages 3-303 


DSN9015I — DSN9019! 


DSN9015i PARAMETER parameter-value IS UNACCEPTABLE 


FOR KEYWORD keyword-name 


Explanation: The parameter value specified in the message is 
not an acceptable value for the named keyword. 


As an example, consider a keyword called PRINT that can have 
parameters of YES or NO. Specification of PRINT(YES) or 
PRINT(NO) is valid. However, specification of PRINT(MAYBE) is 
unacceptable. 


[ — ~~~ _ Internal DB2 Information se = 
This message is issued by the following CSECT(s): DSN9SCND 


(eee End of Internal DB2 Information Ree: 


System Action: Processing for the command is terminated. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference for a list of acceptable parame- 
ters. Correct and reissue the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal tog to verify the command entry. 


DSNS016I verb-name COMMAND REJECTED, UNAUTHOR- 


IZED REQUEST 


Explanation: The command specified in the message (as 
'verb-name') requires that you have proper authorization in 
order to use the command. You do not have the required 
authorization. 


a ~~ Internal DB2 Information Fa | 
This message is issued by the following CSECT(s): DSN9SCNP 


ees End of Internal DB2 Information A Net a nai 


System Action: The command is not executed. Processing is 
terminated. 


Operator Response: If the command must be executed on 
behalf of the user and your instaliation operating procedures 
permit it, enter the command on request. 


System Programmer Response: Contact the system pro- 
grammer responsible for system security, and request that this 
person grant you authorization to use the command. Other- 
wise, you must have someone who is authorized issue the 
command for you. If necessary, request the system operator to 
enter the command for you. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSN90171 FAILURE WHILE PROCESSING verb-name pkw- 


name COMMAND, PROCESSING TERMINATED 


Explanation: The DB2 command processor has abnormally ter- 
minated while processing the command (specified in the 
message as 'verb-name pkw-name'). The error is been 
recorded in SYS1.LOGREC, and an SVC dump is requested. 
The command may have partially completed. Refer to any prior 
response messages to determine what has been done. 


3-304 DB2 Messages and Codes 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSN9SCNP 


Lo End of tnternal DB2 Information ooo ts tal 


System Action: Processing for the command is terminated. 


Operator Response: If a dump was produced, have it printed. 
Print a copy of the contents of the SYS1.LOGREC data set for 
the time period involved. Forward these items with a copy of 
the system log to the system programmer. 


System Programmer Response: Reissue the command. If a 
second failure occurs, consult your supervisor. 


Problem Determination: Obtain a copy of the system or ter- 

minal log to verify command entry. Contact the system oper- 
ator to make sure that diagnostic information is forwarded to 
you. 


DSN9018! csect-name ABORTING verb-name PROCESSING 


DUE TO INSUFFICIENT STORAGE AVAILABLE 


Explanation: The command processor was unable to obtain 
sufficient storage to complete processing of any response mes- 
sages generated by the invoked command. 


| Internal DB2 Information _ ~ | 


This message is issued by the following CSECT(s): DSN9SCN8, 
DSNOSCNF 


(eel os End of internal DB2 Information Mesa ae) 


System Action: Processing for the command is terminated 
abnormally. 


Operator Response: Notify the system programmer before 
attempting to reissue the command. 


System Programmer Response: Determine the reason for 
insufficient storage available to the command. If a cursory 
examination of the system indicates that the region sizes for 
DB2 are sufficient, and the current workload does not seem 
excessive, then a MVS Console dump (MVS DUMP command) 
may be required. 


Insure that any retry steps defined by the command are per- 
formed prior to reissuing the command. 


Problem Determination: The invoked command had completed 
processing and returned to the Command Preprocessor when 
an attempt was made to obtain storage from the address space 
from which the command was entered. Since sufficient storage 
was unavailable, no response messages from the invoked 
command are available. 


DSN90191 VERB verb-name IS NOT A KNOWN COMMAND 


Explanation: The command represented by the verb specified 
in the message is not known to the system; it is an undefined 
command. A possible cause for this error is that you made a 
spelling error while entering the command. 


eile a Internal DB2 Information =a 
This message is issued by the following CSECT(s): DSNSSCND 


Ls End of Internal DB2 Information _____—_— 


System Action: Processing for the command is terminated. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference for the correct command 
format. 


Problem Determinatian: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


DSN90201 KEYWORDS name1 AND name2 CANNOT BE 


USED TOGETHER ON THIS COMMAND 


Explanation: The command requires that either keyword 
‘namei1' OR keyword 'name2' be specified. It is not valid to 
specify both keywords at the same time on this command. 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSNSSCND 


re End of Internal DB2 Information eae 


System Action: Processing for the command is terminated. 


System Programmer Response: Reissue the command, but 
omit the inappropriate keyword. Refer to Chapter 2 of 
Command and Utility Reference for descriptions of the two 
keywords. 


Problem Determination: Obtain a copy of the system or ter- 
minal fog to verify the command entry. 


DSNS0211 VERB verb-name REQUIRED KEYWORD IS 


MISSING 


Explanation: The command specified in the message (as 
‘verb-name') was entered, but at least one required keyword is 
missing. The command processor was unable to determine 
which keyword or keywords were missing. 


| ~~ _ Internal DB2 Information ~~ ae | 
This message is issued by the following CSECT(s): DSNSSCND 


Ue oe End of Internal DB2 Information eee | 


System Action: Processing for the command is terminated. 


System Programmer Response: Refer to Chapter 2 of 
Command and Utility Reference for the proper format of the 
named command, and then reenter the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal fog to verify command entry. If a failure is suspected, 
take a storage dump. 


DSN90221 csect-name verb-name pkw-name NORMAL 


COMPLETION 


Explanation: All synchronous processing for the command 
specified in the message as 'verb-name pkw-name' has com- 
pleted successfully. Any tasks executing asynchronously on 
behalf of the specified command may still be executing when 
this message is displayed. 


DSN9020i — DSN9024I 


iF. —~_ {nternal DB2 Information ~ | 


This message is issued by the following CSECT(s): 


DSNJCO001 DSNTDCST DSNUGCCC 
DSNVDTM DSNVRIM DSNWTCMD 
DSNYASCP DSNYSCMD 


bee End of Internal DB2 Information eee ee sl 


System Action: Synchronous processing for the specified 
command is complete. Subsequent system actions defined by 
the command are documented in Chapter 2 of Command and 
Utility Reference under the associated command. 


DSN90231 csect-name verb-name pkw-name ABNORMAL 


COMPLETION 


Explanation: The command specified in the message (as 
‘verb-name pkw-name') has completed unsuccessfully. The 
command has issued one or more error messages prior to this 
message. The name of the CSECT that issued the message is 
shown at the beginning of the message as a diagnostic aid. 


[ ay = ~ Internal DB2 information ~~ : | 


This message is issued by the following CSECT(s): 


DSNJC001 DSNTDDIS DSNTDCST 
DSNUGCCG  DSNVDTM DSNVRIM 
DSNWTCMD DSNYSTRT DSNYSCMD 
DSNSSCND 


Doge Pes End of Internal DB2 Information ee ee 


System Action: Processing for the command has ended. 


System Programmer Response: Proceed as indicated by prior 
error messages. 


DSNS$0241 KEYWORD keyword-name PARAMETER MAY NOT 


SPECIFY A RANGE OF VALUES 


Explanation: The parameter of the keyword specified in the 
message specifies a range using the colon operator, (for 
instance, 1:3), but a range of values is not allowed. 


As an example, consider a keyword called CLASS. You might 
enter CLASS(1,2,3) to specify classes 1, 2, and 3, or you might 
enter CLASS(1:3). However, not all commands allow you to 
specify a range of values. 


= internal DB2 Information ee ee ee wo 
This message is issued by the following CSECT(s): DSN9SSCND 


=e End of Internal DB2 Information eee 


System Action: Processing for the command is terminated. 


System Programmer Response: Correct the keyword param- 
eter, and reenter the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 
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DSN90261 — DSN9032! 


DSN9026! KEYWORD keyword-name PARAMETER(S) MUST 
BE ALPHABETIC 

DSN9027I KEYWORD keyword-name PARAMETER(S) MUST 
BE ALPHAMERIC 

DSN9028! KEYWORD keyword-name PARAMETER(S) MUST 
BE NUMERIC 


Explanation: Parameter values for the keyword (specified on 
these messages) must be of a specific type, such as all ALPHA- 
BETIC or all ALPHAMERIC / NATIONAL characters, or all 
NUMERIC values. 


As an example of this type of error, consider the keyword 
NAME, where you are expected to enter a person’s last name. If 
you enter NAME(Jones) it is acceptable, but if you enter 
NAME(Jon4s), it is not acceptable. 


As a second example, consider a keyword WEIGHT that speci- 
fies a numeric weight. Entering WEIGHT(47) is acceptable, but 
entering WEIGHT(4u) is not. 


| eo Internal DB2 Information ~~ | 


These messages are issued by the following CSECT(s): 
DSN9SSCND 


Ue cee, oe End of Internal DB2 Information ia oesecyesll 


System Action: Processing for the command is terminated. 


System Programmer Response: Reissue the command but 
ensure that the parameters for the named keyword are of the 
required type. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify the command entry. 


csect-name FAILURE WHILE PROCESSING A 
COMMAND 


DSNS90291 


Explanation: A failure has been encountered while processing 
a command. The command may or may not have been exe- 
cuted. The error has been recorded in the system error log 
(the SYS1.LOGREC data set), and an SVC dump was attempted. 


| Internal DB2 Information | 


This message is issued by the following CSECT(s): DSN9SCN6, 
DSN9SCN7, DSNSSCND 


[tet tn: End of Internal DB2 Information ite ae 


System Action: Processing for the command is terminated. 


Operator Response: If a dump was produced, have it printed. 
Print a copy of the contents of the SYS1.LOGREC data set for 
the time period involved. Forward these items with a copy of 
the system log to the system programmer. 


System Programmer Response: Reissue the command. ifa 
second failure occurs, consult your supervisor or the system 
programmer. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. Contact the system oper- 


3-306 DB2 Messages and Codes 


ator to make sure that diagnostic information is forwarded to 
the system programmer. 


DSN90301 KEYWORD keyword-name PARAMETER MAY NOT 


SPECIFY A SUBSET OF VALUES 


Explanation: The parameter for the keyword specified in the 
message identifies a subset using the asterisk operator (for 
instance, ABC‘), but a subset is not allowed. 


As an example, consider a keyword called NAME, for which you 
can specify people’s names. You might specify NAME(ROBERT 
ROBERTS ROBINSON) to enter three names, or you might 
specify NAME(ROB?’) to indicate all names that begin with the 
characters ROB. However, not all commands allow you to 
specify a subset of values in this way. 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNSSCND 


eee eS End of Internal DB2 Information pases os 2 3) 


System Action: Processing for the command is terminated. 


System Programmer Response: Correct the keyword param- 
eter, and reenter the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSNS90311 SYNTAX ERROR DETECTED FOLLOWING 


KEYWORD keyword-name 


Explanation: The text that follows the named keyword contains 
invalid syntax. 


As an example, consider specification of CLASS= =A. The 
double equal signs do not conform to the rules of syntax and 
make the keyword meaningless. This is just one example of 
invalid syntax. It is not practical to try to illustrate every pos- 
sible error here. You could, however, correctly specify 
CLASS =A or CLASS(A). 


| Internal DB2 Information 
This message is issued by the following CSECT(s): DSNSSCND 


lee eee End of Internal DB2 Information eee 


System Action: Processing for the command is terminated. 


System Programmer Response: Examine the text following the 
named keyword to ensure that no errors were made as the 
command was entered. Ensure that you have followed the 
rules for command entry, and reenter the command. 


Problem Determination: Obtain a copy of the system or ter- 
minal log to verify command entry. 


DSN9032I REQUESTED FUNCTION IS NOT AVAILABLE 


Explanation: An attempt was made to invoke a command 
processor that was not loaded. An example of this is invoking 
-START DDF or -STOP DDF when DDF is not loaded (not 
selected during the installation process). 


| 


Internal DB2 Information 
This message is issued by the following CSECT(s): DSN9SSCNP 


Re ee End of Internal DB2 Information as 


System Action: The requested function is not performed. 


User Response: Determine what function was requested. Do 
not invoke this function until DB2 is reinstalled and DDF is 
selected. 


Problem Determination: Look at the console log to determine 
which command caused the error. 
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Section 4. DB2 Codes 


DB2 Codes 4-1 





introduction 


This section contains DB2 abend reason codes. In 
addition, this section contains DB2 instrumentation 
facility interface reason codes. 


Conventions used in DB2 abend reason codes are 

described in “Section 1. Introduction” on page 1-1. 
A discussion of the subsystem termination reason 

codes associated with message DSNVO86E is also 

given there. 


DB2 Codes 4-3 


00010002 — 00010202 





Call Attachment Abend Reason Codes (X'C1') 


00010002 


Explanation: The DB2 call attachment facility control block (the 
CAB) indicated that a thread was present when it should not 
have been present. 


[ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACA00 


on aeeae End of Internal DB2 Information aa 


User Response: Notify your system programmer. 


System Programmer Response: Collect a DSNTRACE trace 
stream and request a SYSABEND or SYSUDUMP dump. 


Problem Determination: This is probably a call attachment 
facility error. 


00010003 


Explanation: The DB2 call attachment facility received control 
after a non-standard entry that did not use the call attachment 
facility Language Interface. 


[ internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNACAOO 


[oe oe ear ol End of internal DB2 Information _ 


User Response: Modify or repair your application so that 
DSNACAOO, the main call attachment facility code will receive 
control only through the Language Interface. 


Problem Determination: This is probably a user error. 


00010004 


Explanation: The call attachment facility encountered an error 
retrieving a trace message during processing of a call attach- 
ment facility request. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACAOO 


a End of Internal DB2 Information id 


User Response: Notify your system programmer. 


System Programmer Response: Collect a DSNTRACE trace 
stream and request a SYSABEND or SYSUDUMP dump. 


Problem Determination: This is probably a call attachment 
facility error. 


00010005 


Explanation: The application program passed an ECB address 
of 0 to the call attachment facility on a CONNECT call. The trace 
message preceding the abend indicates whether the ECB was a 
start-up or termination ECB. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACAO00 


ee Lec ee End of Internal DB2 Information a er 


User Response: Correct the application program that makes 
the CONNECT call to DSNALI. Ensure that the CONNECT call 
uses a valid ECB address. 


Problem Determination: See the Explanation above. 


00010201 


Explanation: The application program passed two CONNECT 
calls to the call attachment facility (CAF) from the same TCB. 
The first CONNECT could have been either implicit or explicit. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACA0O . 


eeeetes ate End of Internal DB2 Information sd 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Explanation above. 


00010202 


Explanation: The application program passed two OPEN com- 
mands to the call attachment facility (CAF) from the same TCB. 
The first OPEN could have been either implicit or explicit. 


[ ~~~ _ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACAOO. 


a End of Internal DB2 Information ae 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Explanation above. 


DB2 Codes 4-5 


00010203 — 00010823 


00010203 


Explanation: A CLOSE command was issued when there was 
no active OPEN. 


[ — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACAO00 


(enna End of Internal DB2 Information eats en 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Explanation above. 


00010204 


Explanation: A DISCONNECT command was issued when there 
was no active CONNECT. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACAOO 


be ages End of Internal DB2 Information _ 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Explanation above. 


000710205 


Explanation: A TRANSLATE command was issued when the 
DB2 subsystem was not connected to the call attachment facility 
(CAF). 


: as Internal DB2 Information ~~ ie | 


This abend reason code is issued by the following CSECT(s): 
DSNACAO0 


| snd of Internal DB2 Information Sd 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Expianation above. 


00C10206 
Explanation: One of the following conditions exists: 


¢ The wrong number of parameters were issued. 
¢ The end of list bit was off. 


Internal DB2 Information ~""——_—<;7; 


This abend reason code is issued by the following CSECT(s): 
DSNACAOO 


eres End of Internal DB2 Information _ 


4-6 DB2 Messages and Codes 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Explanation above. 


00010207 


Explanation: The application program passed an unrecognized 
function parameter to the call attachment facility (CAF). 


| Internal DB2 Information = ee il 


This abend reason code is issued by the following CSECT(s): 
DSNACAOO 


Wh ee eee End of Internal DB2 Information Deena 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Explanation above. 


00010208 


Explanation: The call attachment facility (CAF) received 
requests from the same TCB to CONNECT to the DB2 subsystem 
and to another subsystem. 


| ” TS Internal DB2 Information ~~ - - 


This abend reason code is issued by the following CSECT(s): 
DSNACAOO 


[ie eee ee End of Internal DB2 Information eA sind 


User Response: You may continue processing with a corrected 
request. 


Problem Determination: See the Explanation above. 


00010823 


Explanation: There is a release level mismatch between DB2 
and the Call Attachment Facility code. 


| = ; Internal DB2 Information ~~ ee | 


This reason code is issued by the following CSECT(s): 
DSNACA70 


| End of Internal DB2 Information —_____——_| 


User Response: You may continue processing with a corrected 
response. 


Problem Determination: See the Explanation associated with 
message DSNA823l. 


00010824 


Explanation: The CAB is reset and a new connection may be 
made. 


00010824 — 00C10824 


internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNACA70 


fet End of Internal DB2 Information eee 


User Response: You may continue processing. 


Problem Determination: See the Explanation associated with 
message DSNA824iI. 


DB2 Codes 4-7 


Buffer Manager Codes (X‘C2") 


00C200A3 


Explanation: This is a DB2/MVS internal error. The execution 
unit driving a buffer manager (BM) asynchronous function, 
which would normally run indefinitely, has been canceled. 
However, work being done by the execution unit is allowed to 
complete before the execution unit terminates. 


—————— Internal DB2 Information ~~ 


This abend reason code is issued by the following CSECT(s): 
DSNB1CMS, DSNB5COM, DSNB5RAP 


bee End of Internal DB2 Information id 


System Action: The affected asynchronous function is termi- 
nated. If the affected function is the deferred write processor 
(DSNB1CMS), DB2 is abended with the abend code '00C200D3'. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Start DB2 if it is 
abended. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Coilect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200A4 


Explanation: Typically, this indicates a problem internal to 
DB2; however, the problem can result from errors in other pro- 
ducts. An unexpected reason code was returned by the media 
manager function when it was invoked to process a database 
\/O request. 


ye. Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNB1GET, DSNB5COM, DSNB5RAP 


renner End of Internal DB2 Information ae: 


System Action: The requesting execution unit is abended. 


User Response: Notify the system programmer and rerun the 
application. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected media manager 
reason code is saved in register 8. It may help determine the 
cause of the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 10, 11. 


00C200A3 — 00C200A6 


00C200A5 


Explanation: Typically, this indicates a problem internal to 
DB2; however, the problem can result from errors in other pro- 
ducts. The buffer manager (BM) subcomponent of DB2 was 
unable to obtain an exciusive lock on a page set in preparation 
for page set cleanup processing. This may be caused by one of 
the following: 


¢ The associated object is allocated to a DB2 utility function. 

* The associated object has been dropped because of a 
backout. 

¢ An IRLM out-of-storage condition was detected. 

¢ An internal error has been detected in the data manager 
lock acquisition function. 


ee ~ Internal DB2 Information _ | 


This abend reason code is issued by the following CSECT(s): 
DSNBiCFC 


Be a ee End of Internal DB2 information oe Ae 


System Action: The execution unit driving this function pro- 
ceeds normally. The abend status is recorded in 
SYS1.LOGREC. 


Operator Response: Notify the system programmer and print 
the SYS1.LOGREC. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. Restart 
DB2. 


Problem Determination: The unexpected reason code returned 
by the data manager CREATE PSCB function is saved in reg- 
ister 8. It may help determine the cause of the problem. If the 
problem is caused by an unavailable DB2 resource (for 
example, the table space/index space is allocated to a DB2 
utility function), message DSNT500! may also be issued. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00C200A6 


Explanation: This is a DB2/MVS internal error. The execution 
unit scheduled by the buffer manager (BM) subcomponent of 
DB2 to drive the page set cleanup function has been canceled. 


=. Internal DB2 Information ~_ 7 | 


This abend reason code is issued by the following CSECT(s): 
DSNB1CFC 


tes ees End of Internal DB2 Information eg 


System Action: DB2 is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


DB2Codes 4-9 


00C200A8 — 00C200B1 


Problem Determination: Refer to similar reason code 
'00E50013'. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200A8 


Explanation: An error code (other than timeout, insufficient 
storage, or MVS system error) was returned by the IRLM LOCK 
request that was invoked to acquire a table space lock to 
record SYSLGRNG. 


(— -- Internal DB2 Information _ 


This abend reason code is issued by the following CSECT(s): 
DSNB1SWS, DSNB1SWU 


ie ee End of Internal DB2 Information eee 


System Action: The requesting execution unit is abended. 


User Response: Notify the system programmer and rerun the 
application. 


Operator Response: Notify the systern programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected IRLM reason code is 
saved in register 8. It may help determine the cause of the 
error. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200A9 


Explanation: A return code greater than 4 was returned by the 
IRLM UNLOCK request that was invoked to release a table 
space lock after recording the SYSLGRNG. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNB1SWS, DSNB1SWU 


a End of Internal DB2 Information a 


System Action: The requesting execution unit is abended. 


User Response: Notify the system programmer and rerun the 
application. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected IRLM reason code is 
saved in register 8. It may help determine the cause of the 
error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


4-10 DB2 Messages and Codes 


00C200B0 


Explanation: Typically, this indicates a problem internal to 
DB2, however the problem can result from errors in other pro- 
ducts. The buffer address passed by the buffer manager (BM) 
invokers does not contain the requested page. The buffer 
manager detected this error by comparing the information 
stored in the buffer control block (BB) with the information 
passed with the buffer manager by its invokers. The informa- 
tion that is compared is the page set piece block, the page 
number, and the buffer address. 


| Internal DB2 Information ~~ oS | 


This abend reason code is issued by the following CSECT(s): 


DSNB1GET DSNB1REL DSNBiRWI 
DSNB1SWS DSNB1SWU DSNBIGNV 
DSNBSCOM 


|______ End of internal DB2 Information ______| 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: 


The following general purpose registers (GPRs) contain the 
indicated diagnostic information: 


GPR Content 
7 Address of the page buffer 
8 Address of the page set block (PB) 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 10, 11. 


00C200B1 


Explanation: This is a DB2 internal error. Either the buffer 
manager (BM) subcomponent of DB2 is unable to locate the 
requesting page in the buffer pool or the invoker of the buffer 
manager is attempting to decrease the buffer use count which 
is already 0. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1REL, DSNB1RWI, DSNB1SWS, DSNB1SWU 


[| End of Internal DB2 Information Se | 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200B2 


Explanation: This is a DB2 internal error. The buffer’s write 
intent count is already 0 and the buffer manager (BM) invoker is 
attempting to decrease it. 


ia 77. es Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNB1RWI 


eee End of Internal DB2 Information fone al 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200B3 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 is unable to open a page set 
required by the requesting function. The page size or the page 
set piece size passed by the buffer manager invoker is invalid. 
The page set piece size is expressed by n, where 2 to the 
power of n is the total number of pages that can be contained 
within a page set piece. This error was detected during open 
page set processing. 


po Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1OPS. 


[egy wee selene End of tnternal DB2 Information phe es’ 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200B4 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 is unable to open a page set 
required by the requesting function. The highest page set piece 
number passed by the buffer manager invoker exceeds the 
maximum value allowed. The maximum number of data sets 
that can be defined for a given page set is dependent on the 
page set piece size. This error was detected during open page 
set processing. 


00C200B2 — 00C200B6 


f = + Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB10PS 


[ee see End of Internal DB2 Information fone Il 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200B5 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 is unable to open a page set 
required by the requesting function. During the open page set 
processing, the page set options passed by the buffer manager 
invoker were in conflict with the same page set that was 
opened earlier. The page set options are the writing protocol 
(SYSTEM or UW), the recovery option (recoverable or unrecov- 
erable), and the page size. 


| internal DB2 information ~ aa 


This abend reason code is issued by the following CSECT(s): 
DSNB10OFA 


| End of internal DB2 Information 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200B6 


Explanation: Typically, this indicates a problem internal to 
DB2; however, the problem can result from errors in other pro- 
ducts. The buffer manager (BM) subcomponent of DB2 is 
unable to reallocate a data set that is required after extending a 
data set.to a new volume. The data set reallocation was 
requested and the corresponding data set was not opened. 

This error was detected during open page set piece processing. 


fa Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1OPP 


Ls End of Internal DB2 Information 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


DB2 Codes 4-11 


00C200B7 — 00C200C1 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 10, 11. 


00C200B7 


Explanation: Typically, this indicates a problem internal to 
DB2; however, the problem can result from errors in other pro- 
ducts. The buffer manager (BM) subcomponent of DB2 is 
unable to open a page set required by the requesting function. 
The linear page set was not formatted contiguously. This error 
was detected during open page set processing. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1OPS 


eet Ha End of Internal DB2 Information br ee 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 10, 11. 


00C200B8 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 is unable to update the SYSLGRNG 
page set. An unexpected reason code was returned by the 
utility activity history recording function (AHRF). The AHRF was 
invoked to record the first update request after open for a 
recoverable page set. 


| — Interna! DB2 Information ; ey 


This abend reason code is issued by the following CSECT(s): 
DSNB1SWS, DSNB1SWU 


ae: End of Internal DB2 Information Be 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected utility reason code is 
saved in register 8. It may help determine the cause of 
problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


4-12 DB2 Messages and Codes 


00C200B9 


Explanation: The requesting execution unit is being forced to 
terminate. 


| Internal DB2 Information ; | 


This abend reason code is issued by the following CSECT(s): 


DSNB1GET DSNB1SWS DSNB1SWU 
DSNB5COM DSNB5FOR DSNBSSDO 


ed eine? End of Internal DB2 Information Seger ann 


System Programmer Response: See similar abend code 
'00E50013'. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 


00C200C0 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to perform I/O processing for the requesting function. 
An error code (other than a permanent I/O error) was returned 
by the media manager during the I/O backend processing. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1GET, DSNB5COM, DSNB5FOR, DSNBSRAP 


Eee a End of Internal DB2 Information fot S| 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected media manager 
reason code is saved in register 8. It may help determine the 
cause of the failure. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 10, 11. 


00C200C1 


Explanation: The log RBA in the database page header is 
beyond the end of the log. 


a = Internal DB2 Information ~—— aT 4 


This abend reason code is issued by the following CSECT(s): 
DSNB1RWI, DSNB1SWS, DSNB1SWU 


| End of Internal DB2 Information 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: The following general purpose regis- 
ters (GPRs) contain the indicated diagnostic information: 


GPR Content 
7 Address of the page buffer 
8 Address of the page set block (PB) 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 12, 32. 


‘00C200C2 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 has discovered that the BM invoker 
is attempting to decrease the page’s write intent count (WIC), 
but the invoker has no write intent request outstanding. 


| © Internal DB2 tnformation | 


This abend reason code is issued by the following CSECT(s): 
DSNB1RWI 


eee End of Internal DB2 Information en 


System Action: The BM does not decrease the page’s WIC as 
requested, and the execution unit driving this function is 
abended. An SVC dump is requested and the abend status is 
recorded in the SYS1.LOGREC. 


Operator Response: Notify the system programmer, print the 
SYS1,.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 12, 18, 32. 


00C200C3 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 has discovered that the BM invoker 
is attempting to set the page’s write intent count (WIC), but the 
invoker has no read intent request outstanding. 


~ Internal DB2 Information ~— _ ae | 


This abend reason code is issued by the following CSECT(s): 
DSNB1SWS 


[ee ee End of Interna! DB2 Information ee eel 


System Action: The BM does not increase the page’s WIC as 
requested, and the execution unit driving this function is 
abended. An SVC dump is requested and the abend status is 
recorded in the SYS1.LOGREC. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 18, 32. 


00C200C2 ~— 00C200C7 


00C200C5 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 discovered that its invoker was 
attempting to decrease the write dependency count (WDC) for a 
buffer. However, the buffer contains database updates that 
have not yet been written back to DASD. The buffer manager 
makes the buffer available for reassignment. 


: Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNB1REL, DSNB1RWI 


eer End of internal DB2 Information eee eee 


System Action: The buffer manager does not decrease the 
WDC as requested, and the execution unit driving this function 
proceeds normally. An SVC dump is requested and the abend 
status is recorded in SYS1.LOGREC. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 12, 18, 32. 


00C200C6 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 has discovered that the BM invoker 
is attempting to release a page that was not held by the invoker 
or the page has an unbalanced write intent (for example, reset 

write intent has not yet been issued prior to releasing the 


page). 


a = Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNBIREL, DSNBIRWI 


———— End of Internal DB2 Information | 


System Action: The BM does not release the page as 
requested, and the execution unit driving this function termi- 
nates abnormally. An SVC dump is requested and the abend 
status is recorded in the SYS1.L.OGREC. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 12, 18, 32. 


00C200C7 


Explanation: An error code, other than timeout, insufficient 
storage, or MVS system error, was returned by the IRLM LOCK 
request. The IRLM LOCK request was invoked to acquire an 
open lock to perform a physical open or close. 


DB2 Codes 4-13 


00C200C8 — 00C200CB 


[ — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1ILCK 


coer ee End of Internal DB2 Information pe 


System Action: The requesting execution unit is abended. 
User Response: Rerun the application. 


Operator Response: Print the SYS1.LOGREC and request the 
SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected IRLM reason code is 
saved in register 8. It may help determine the cause of the 
error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200C8 


Explanation: A return code greater than 4 was returned by the 
IRLM UNLOCK request invoked to release a open lock after 
completing a physical open or close. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1ULK 


———e End of internal DB2 Information See ee 


System Action: The requesting execution unit is abended. 
User Response: Rerun the application. 


Operator Response: Print the SYS1.LOGREC and request the 
SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected IRLM reason code is 
saved in register 8. It may help determine the cause of the 
error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200C9 


Explanation: The buffer manager (BM) subcomponent of DB2 
discovered a damaged PBG control block while attempting to 
write a check point log record. 


ve Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1CHK 


Ve eee End of Internal DB2 Information _ 
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System Action: DB2 is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 32. 


00C200CA 


Explanation: The buffer manager (BM) subcomponent of DB2 
detected an error in the the sequential least recently used 
(SLRU) or the least recently used (LRU) buffer chain. Buffer 
control blocks have been corrupted or overlaid. 


a ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNB1ABO DSNB1CFC DSNB1CPP 
DSNB1GET DSNBi1LRR DSNB1REL 
DSNB1RRR DSNB1RTR DSNB1RWI 
DSNB5COM DSNB5RAP 


[End of internat DB2 Information ___ 


System Action: The requesting execution unit is abended. If 
the abend occurs in DSNB1LRR, DB2 may abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200CB 


Explanation: The buffer manager (BM) subcomponent of DB2 
discovered a damaged ABG or AB control block while 
attempting to write a checkpoint. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(S): 
DSNB1CHK 


ee eee End of Internal DB2 Information ieee esl 


System Action: DB2 is abended; to allow further processing, it 
would create an invalid checkpoint which would damaged data 
on a subsequent DB2 restart. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on. page X-5: 1, 
5. 


00C200D0 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to perform I/O processing for the requesting function. 
A prior abend has occurred in the buffer manager (BM) I/O ter- 
mination exit routine. Retry of the prior abend is not allowed by 
MVS. 


| Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNB5UTX 


| cae End of internal DB2 Information rete 


System Action: DB2 is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The functional recovery routine (FRR) 
parameter list was recorded in the SDWA variable recording 
area (VRA) when the original abend occurred. Examine the VRA 
to determine whether the media manager request block 
(MMRB) is properly passed by the media manager. 


For information about finding the SDWA, refer to Section 2 of 
Diagnosis Guide and Reference 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C20001 


Explanation: The buffer manager (BM) subcomponent of DB2 


is unable to perform 1/O processing for the requesting function. | 


A prior abend has occurred in the buffer manager I/O termi- 
nation exit routine. An attempt to retry and to continue main 
line processing (after completion of processing of this prior 
abend) resulted in recursion to the I/O termination exit routine’s 
functional recovery routine (FRR). 


| Internal DB2 Information ~ “si 


This abend reason code is issued by the following CSECT(s): 
DSNB5UTX 


ieee tek End of Internal DB2 Information S| 


System Action: DB2 is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The FRR parameter list was recorded 
in the SDWA variable recording area (VRA) when the original 
abend occurred. Examine the VRA to determine whether the 
media manager request block (MMRB) is properly passed by 
the media manager. For information about finding the SDWA, 
refer to Section 2 of Diagnosis Guide and Reference 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200D0 — 00C200D4 


00C200D2 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to perform I/O processing for the requesting function. 
A prior abend has occurred in the buffer manager !/O error exit 
routine during processing of a database I/O error. 


——* — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB5UEX 


ere End of Internal DB2 Information S| 


System Action: DB2 is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The functional recovery routine (FRR) 
parameter list was recorded in the SDWA variable recording 
area (VRA) when the origina! abend occurred. Examine the 
VRA to determine whether the media manager request block 
(MMRB) is properly passed by the media manager. For infor- 
mation about finding the SDWA, refer to Section 2 of Diagnosis 
Guide and Reference 


Coltect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200D3 


Explanation: A prior abend occurred in a ‘must complete’ 
processing window of a buffer manager (BM) function. 


a Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1RRR 


et — oe End of Internal DB2 Information _ 


System Action: DB2 is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: See the Problem Determination 
section of the original abend code. 


Colleg¢t the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200D4 


Explanation: A prior abend occurred in an I/O processing 
window of a buffer manager (BM) function. I/O functional 
recovery cannot be reliably performed because the tracking 
data required to do so is incomplete. The required data is 
probably missing because the functional recovery routine (FRR) 
that is protecting the abending !/O processing function was 
bypassed by MVS. 
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00C200D5 — 00C200D8 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1RRR 


ee ee End of Internal DB2 Information oe 


System Action: DB2 is abended. 


Operator Response: Notify the system programmer, and print 
the SYS1.LOGREC and the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: See the Problem Determination 
section of the original abend code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200D5 


Explanation: An abend occurred in the !/O termination exit 
routine while resuming the suspended execution unit. The 
status of resume was ‘indoubt' at the time of the abend. 


| Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNB5UTX 


ee End of Internal DB2 Information tenet 


System Action: DB2 is abnormally terminated. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The functional recovery routine (FRR) 
parameter list was recorded in the SDWA variable recording 
area (VRA) when the original abend occurred. Examine the 
VRA to determine whether the media manager request block 
(MMRB) is properly passed by the media manager. For infor- 
mation about finding the SDWA, refer to Section 2 of Diagnosis 
Guide and Reference 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200D6 


Explanation: An abend occurred in the {/O termination exit 
routine while resuming the suspended execution unit. The 
status of resume was 'indoubt' at the time of the abend. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB5UTX 


= End of Internal DB2 Information Patent: 


System Action: DB2 is abnormally terminated. 
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Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The functional recovery routine (FRR) 
parameter list is recorded in the SDWA variable recording area 
(VRA) when the original abend occurred. Examine the VRA to 
determine whether the media manager request block (MMRB) 
is properly passed by the media manager. For information 
about finding the SDWA, refer to Section 2 of Diagnosis Guide 
and Reference 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00C200D7 


Explanation: A prior abend occurred while resuming a Sus- 
pended execution unit. The status of resume was 'indoubt' at 
the time of the abend. 


| Internal DB2 Information “| 


This abend reason code is issued by the following CSECT(s): 
DSNB1RRR 


L End of Internal DB2 Information id 


System Action: DB2 is abnormally terminated. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: See the Problem Determination 
section of the original abend code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 7 


00C200D8 


Explanation: This is a DB2 internal error. The buffer manager 
(BM) subcomponent of DB2 discovered that some buffer 
manager resources are inconsistent. 


| Internal DB2 Information ~~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNB5COM, DSNB1CMS 


leet, ee End of Internal DB2 Information eh itl 


System Action: DB2 is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00C200E0 


Explanation: The buffer pooi static size was not initialized. A 
DB2 message, DSNB602I, was issued to inform the operator of 
the error. The error was detected during open page set proc- 
essing when an attempt was made to create the buffer pool. 
This reason code and the buffer pool 1D are recorded in the 
cursor table (CT) and made available to the user in the SQLCA 
or in messages. 


| — Internal DB2 Information ~~ ———~S<‘<O:C 


This abend code is issued by the following CSECT(s): 
DSNB10PS 


ee End of Internal DB2 Information | 


System Action: A ‘resource not available' code is returned to 
the user. 


Operator Response: Ask the database administrator to change 
the buffer pool size to a nonzero value. 


System Programmer Response: Change the buffer pool size to 
a nonzero value, using either the BUFFER parameter of the 
DSN6SPRM assembler macro in the DSNTIJUZ job stream or 
the DB2 installation storage sizes panel (DSNTIPES). Then, 
resubmit the installation job, DSNTIJUZ, specifying the name of 
the load module that is specified after the PARM= parameter of 
the -START DB2 command in the NAME parameter of the link- 
edit SYSIN. 


Problem Determination: The buffer pooi (pool ID is indicated in 
the DSNB602!1 message and in the SQLCA) minimum size is 
zero. This is defined in the BUFFER parameter of the 
DSN6SPRM assembler macro in the DSNTIJUZ job stream. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 9. 


00C200E1 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to open a data set that is required to be accessed by 
the requesting function. An error was returned by the media 
manager CONNECT function, which was invoked to open a 
VSAM data set. DB2 message DSNB204I was issued to inform 
the operator of the error condition. This reason code and the 
data set name are recorded in the cursor table (CT) and made 
available to the user in the SQLCA or in messages. 


a ———— Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB10ST 


eS ee End of Internal DB2 Information peed 


System Action: A ‘resource not available' code is returned to 
the user. Abend status is recorded in SYS1.LOGREC. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to system message 
1EC 1611 and DB2 message DSNB204I for assistance in deter- 
mining the cause of the error. Correct the situation, and notify 
the user to reinvoke the application. 


Problem Determination: The unexpected media manager 
return code is saved in register 8. It may help determine the 
cause of the failure. 


00C200E0 — 00C200E5 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 10, 11. 


00C200E2 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to open a data set that is required by the requesting 
function. An error was returned by the dynamic allocation func- 
tion that was invoked to allocate a VSAM data set. DB2 
message DSNB207! was issued to inform the operator of the 
error condition. This reason code and the data set name are 
recorded in the cursor table (CT) and made available to the 
user in the SQLCA or in messages. 


| -—s— Interna! DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB10ST 


erent End of Internal DB2 Information a 


System Action: A ‘resource not available' code is returned to 
the user. Abend status is recorded in SYS1.LOGREC. 


User Response: Notify the system programmer. Reinvoke the 
application after the system programmer has corrected the 
error. 


Operator Response: Notify the system programmer. 


System Programmer Response: The error code returned from 
the dynamic allocation function was externalized in the 
DSNB207! message. Refer to the appropriate MVS publication 
for an explanation of this error code. Correct the situation, and 
notify the user to invoke the application again. 


Problem Determination: The unexpected dynamic allocation 
return code is saved in register 8. It may help determine the 
cause of the failure. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 10, 11. 


00C200E5 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to perform the I/O operation on a data set that is 
required by the requesting function. A logical I/O error was 
detected by the buffer manager I/O functions. The logical I/O 
error indicates that a requesting page (read operation) is 
residing within the error page range of the data set. This 
reason code and the data set name are recorded in the cursor 
table (CT) and made available to the user in the SQLCA or in 
messages. 


| : Internal DB2 Information “ed 


This abend reason code is issued by the following CSECT(s): 
DSNB1GET, DSNB5COM 


nee End of Internal DB2 Information eae 


System Action: A ‘resource not available’ code is returned to 
the user. 


User Response: Notify the system programmer. Invoke the 
application after the system programmer has corrected the 
error. 


Operator Response: Use the -DISPLAY DB command to obtain 
the error page range. Notify the system programmer. 
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00C200E6 — 00C200F1 


System Programmer Response: The error page range can be 
located from the console sheet or through the -DISPLAY DB 
command. Correct the error pages with the recovery utility, 
and notify the user to invoke the application again. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: Coliect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
10, 11. 


00C200E6 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to perform the I/O operation on a data set that is 
required by the requesting function. A permanent I/O error was 
detected by the media manager during preformat processing. 
This reason code and the data set name are recorded in the 
cursor table (CT) and made available to the user in the SQLCA 
or in messages. 


[ — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB5FOR 


DEP ae End of Internal DB2 Information te oe te 


System Action: A 'resource not available’ code is returned to 
the user. 


User Response: Notify the system programmer. Invoke the 
application after the system programmer has corrected the 
error. 


Operator Response: Notify the system programmer. 


System Programmer Response: Recover the entire data set 
with the recovery utility, and notify the user to invoke the appli- 
cation again. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
10, 11. 


00C200E8 


Explanation: The buffer pool (indicated in the SQLCA) cannot 
be expanded because of insufficient virtual storage. Either DB2 
message DSNB601I or DSNB603! was issued to inform the oper- 
ator of the error. This reason code and the buffer pool ID are 
recorded in the cursor table (CT) and made available to the 
user in the SQLCA or in messages. 


rs are Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1GET, DSNB1OPS 


a End of internal DB2 Information ee 


System Action: A ‘resource not available' code is returned to 
the user. 


Operator Response: Notify the system programmer. 


System Programmer Response: If DSNB601I was issued, 
attempt to reduce the concurrent activity. 


if DSNB603! was issued, stop DB2, and reduce the number of 
buffers of this and/or other buffer pools using either the 
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BUFFER parameter of the DSN6SPRM assembler macro in the 
DSNTIJUZ job stream or the DB2 installation storage sizes 
panel (DSNTIPES). Then, resubmit the installation job, 
DSNTIJUZ, specifying the name of the load module that is speci- 
fied after the PARM= parameter of the -START DB2 command 
in the NAME parameter of the Jink-edit SYSIN. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
9. 


00C200E9 


Explanation: The buffer pool (indicated in SQLCA) cannot be 
expanded, because it has already reached its maximum allow- 
able size. DB2 message DSNB601I was issued to inform the 
operator of the error. This reason code and the buffer pool ID 
are recorded in the cursor table (CT) and made available to the 
user in the SQLCA or in messages. 


| Zs Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1GET 


i End of Internal DB2 Information eee | 


System Action: A ‘resource not available' code is returned to 
the user. 


Operator Response: Notify the system programmer. 


System Programmer Response: Reduce concurrent activity by 
reducing the number of DB2 threads, or, if necessary, stop DB2 
and increase the buffer pool maximum size using either the 
BUFFER parameter of the DSN6SPRM assembler macro in the 
DSNTIJUZ job stream or the DB2 installation storage sizes 
panel (DSNTIPES). Then, resubmit the installation job, 
DSNTIJUZ, specifying the name of the load module specified 
after the PARM= parameter of the -START DB2 command in 
the NAME parameter of the link-edit SYSIN. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
9, 


00C200F1 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to unallocate a DB2 data set. An error was returned 
by the dynamic unallocation function that was invoked to unallo- 
cate a data set. This reason code and the data set name are 
recorded in the cursor table (CT) and made available to the 
user in the SQLCA or in messages. 


i -—<—— —~ Internal DB2 Information i 


This abend reason code is issued by the following CSECT(s): 
DSNB1CST 


renee End of Internal DB2 Information ae 


System Action: A ‘resource not available' code is returned to 
the user. The SVC dump and the SYS1.LOGREC recording are 
requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The unexpected dynamic unallocation 
reason code is saved in register 8. It may help determine the 
cause of the failure. Refer to the appropriate MVS publication 
for an explanation of the error code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 10, 11. 


00C200F2 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to close a DB2 data set. An error was returned by the 
media manager DISCONNECT function that was invoked to 
close a data set. This reason code and the data set name are 
recorded in the cursor table (CT) and in the SQLCA or in mes- 
sages. 


a ~ Internal DB2 Information ~————— | 


This abend reason code is issued by the following CSECT(s): 
DSNB1CST 


Weceeneh a ecectes End of Internal DB2 Information be ee oe oe al 


System Action: A 'resource not available’ code is returned to 
the user. The SVC dump and the SYS1.LOGREC recording are 
requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Probiem Determination: The unexpected media manager dis- 
connect reason code is saved in register 8 and may help deter- 
mine the cause of the failure. Locate the corresponding !EC161! 
message in the operator console sheet, and refer to the appro- 
priate MVS publication for assistance in determining the cause 
of the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 10, 11. 


00C200F3 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to obtain a table space lock to perform a SYSLGRNG 
recording. A timeout error was detected by the IRLM LOCK 
request. This reason code and the data set name are recorded 
in the cursor table (CT) and made available to the user in the 
SQLCA or in messages. 


‘a ff a Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNB1SWS, DSNB1SWU 


ees End of Internal DB2 Information eee 


System Action: A ‘resource not available' code is returned to 
the user. 


User Response: Resubmit the failing application. 


00C200F2 — 00C200F6 


00C200F4 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to obtain a table space lock to do the SYSLGRNG 
recording. An out-of-storage condition was detected by the 
IRLM LOCK request. This reason code is recorded in the 
cursor table (CT) and made available to the user in the SQLCA 
or in messages. 


[ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1SWS, DSNB1SWU 


Poros End of Internal DB2 Information ree | 


System Action: A ‘resource not available' code is returned to 
the user. 


User Response: Resubmit the failing application. 


00C200F5 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to obtain a table space lock to perform a SYSLGRNG 
recording. A system error was detected by the IRLM LOCK 

request. This reason code is recorded in the cursor table (CT) 
and made available to the user in the SQLCA or in messages. 


| internal DB2 Information = ay 


This abend reason code is issued by the following CSECT(s): 
DSNB1SWS, DSNB1SWU 


[hie pees End of Internal DB2 Information _ 


System Action: A ‘resource not available' code is returned to 
the user. 


User Response: Resubmit the failing application. 


00C200F6 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to open a data set that is required to be accessed by 
the requesting function. The data set has been migrated by 
DFHSM and the data set must be recalled before being 
accessed. Since the RECALL(yes) option was selected by the 
installation, a recall for the migrated data set has been initi- 
ated. A recall was not complete after the amount of time speci- 
fied in the RECALL option had elapsed. 


This reason code and the data set name are recorded in the 
cursor table (CT) and made available to the user in the SQLCA 
or in messages. The data set name and the reason code indi- 
cated are the last migrated data set requested. Other migrated 
data sets within the table space may exist. For each one that 
exists, a DSNT500I message containing the data set name and 
reason code has been sent to the console. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1RST 


ee End of Internal DB2 Information _ 


DB2 Codes 4-19 


00C200F7 — 00C200FA 


System Action: A ‘resource not available‘ code is returned to 
the user. A DSNT500I message is sent to the console. 


User Response: After the data set has been restored, rerun 
the application program, transaction, or query. If necessary, 
contact the operator to find out the status of the migrated data 
set. 


00C200F7 


Explanation: The page found in the buffer is not the page 
requested by the buffer manager. The buffer manager detected 
the error by comparing the page number of the page returned 
with the requested page number. This error may be caused by 
one of the following: 


e Either the VTOC or VVDS is damaged, causing multiple data 
sets to occupy the same extents on DASD. 

¢ The page was altered incorrectly by a non-DB2 facility or a 
DB2 service aid. 

¢ An internal DB2 error damaged the page. The recovery log 
will be required for problem determination. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1GET 


[eens End of Internal DB2 Information betes 


System Action: The requesting execution unit is abended. 


Operator Response: Notify the system programmer, print the 
SYS1.LOGREC, and request the SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The following general purpose regis- 
ters (GPRs) contain the indicated diagnostic information: 


GPR Content 
7 Address of the page buffer 
8 Address of the page set block (PB) 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 10, 11, 27, 28, 29. 


00C200F8 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to perform the I/O operation on a data set. A physical 
1/O error was detected by the buffer manager I/O functions. 


This reason code and the data set name are recorded in the 
cursor table (CT) and made available to the user in the SQLCA 
or in messages. 


[ Ie, — Internal DB2 Information ~~ ea 


This abend reason code is issued by the following CSECT(s): 
DSNB1GET, DSNB5COM 


Leet wet End of Interna! DB2 Information ee: 


System Action: A 'resource not available' code is returned to 
the user. The error page range of the data set is updated if the 
I/O is a write operation. The error message DSNUOS8GCE is 
issued indicating the data set name and its corresponding I/O 
error page range. 


4-20 DB2 Messages and Codes 


User Response: Notify the system programmer. Invoke the 
application after the system programmer has corrected the 
error. 


Operator Response: Use the -DISPLAY DB command to obtain 
the error page range. Notify the system programmer. 


System Programmer Response: The error page range can be 
located from the console sheet or with the -DISPLAY DB 
command. Correct the error pages with the recovery utility, 
and notify the user to invoke the application again. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
10, 11. 


00C200F9 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to open a data set that is required to be accessed by 
the requesting function. The data set has been migrated by 
HSM and the data set must be recalled before being accessed. 
The attempt by DB2 to initiate a recall of the migrated data set 
was unsuccessful. 


This reason code and the data set name are recorded in the 
cursor table (CT) and made available to the user in the SQLCA 
or in messages. The data set name and the reason code indi- 
cated are the last requested migrated data set. Other migrated 
data sets may exist. For each one that exists, a DSNT500I 
message containing the data set name and reason code has 
been sent to the console. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB10OST 


| End of Internal DB2 Information 


System Action: A ‘resource not available' code is returned to 
the user. A DSNT500I message is sent to the console. The 
page set containing the migrated data set is stopped. 


User Response: Issue the HSM command (HRECALL) to 
restore the migrated data set. Start the page set. Rerun your 
application program, transaction, or query after the data set 
has been restored. 


00C200FA 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to obtain an open lock to perform a physical open or 
close of a page set. A timeout error was detected by the IRLM 
LOCK request. The reason code and the database and page 
set names are recorded in the cursor table (CT). They are 
made available to the user in the SQLCA or in messages. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNB1iLCK 


ere End of Interna! DB2 Information ee 


System Action: A 'resource not available' code is returned to 
the user. 


User Response: Resubmit the failing application. 


00C200FB 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable-to obtain an open lock to perform a physical open or 
close of a page set. An out-of-storage condition was detected 
by the IRLM LOCK request. The reason code and the database 
and page set names are recorded in the cursor table (CT). 
They are available to the user in the SQLCA or in messages. 


eee Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1LCK 


——— a End of Internal DB2 Information _ sd 


System Action: A ‘resource not available’ code is returned to 
the user. 


User Response: Resubmit the failing application. 


00C200FC 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to obtain an open lock to perform a physical open or 
close of a page set. A system error was detected by the IRLM 
LOCK request. The reason code and the database and page 
set names are recorded in the cursor table (CT). They are 
made available to the user in the SQLCA or in messages. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNB1LCK 


[| _seEnd of Internal DB2 Information 


00C200FB — 00C200FE 


System Action: A ‘resource not availabie' code is returned to 
the user. 


User Response: Resubmit the failing application. 


00C200FE 


Explanation: The buffer manager (BM) subcomponent of DB2 
is unable to open a data set that is required to be accessed by 
the requesting function. The data set has been migrated by 
DFHSM and the data set must be recalled before being 
accessed. Since the RECALL(no) option was selected by the 
installation, recall for the migrated data set has not been initi- 
ated. 


This reason code and the data set name are recorded in the 
cursor table (CT) and made available to the user in the SQLCA 
or in messages. The data set name and the reason code indi- 
cated are the last migrated data set requested. Other migrated 
data sets within the table space may exist. For each one that 
exists, a DSNT500I message containing the data set name and 
reason code has been sent to the console. 


a internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNB1RST 


Lo End of Internal DB2 Information =i: — 2 il] 


System Action: A ‘resource not available' code is returned to 
the user. A DSNT500/1 message is sent to the console. The 
page set containing the migrated data set is stopped. 


User Response: Notify the system programmer. After the data 
set has been restored, rerun the application program, trans- 
action, or query. 


System Programmer Response: Issue the DFHSM command 
(HRECALL) to restore the migrated data set. Start the page set. 


DB2Codes 4-21 


00C30001 — 00C30004 





CICS Attachment Facility Codes (X‘'C3') 


For information about the CICS transaction 
abend/dump code DSNC, refer to Appendix A, 
“CICS Transaction Abend/Dump Code (DSNC)” on 
page X-3. 


00C30001 


Explanation: The CICS attachment facility has terminated 
because of errors that cannot be corrected. The CICS attach- 
ment facility module DSNCEXT1 has detected one of the fol- 
lowing conditions: 


¢ The CLOT control biock is invalid 

¢ The CLOT and CCCT element have been disconnected 
before the end of a unit of recovery 

¢ The previous application program support (APS) call failed 
and a commit call is being attempted 


These symptoms may be caused by an overlay of the CLOT 
and/or the CCCT. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNCMSUB 


eee ie End of Internal DB2 Information _ 


System Action: The CICS attachment facility terminates. 
Operator Response: Notify the system programmer. 


System Programmer Response: Analyze the dumps and 
system console messages for storage violations. 


Problem Determination: One or more control blocks do not 
pass validity checks. The most probable cause is that they 
have been overlaid by some user application. A CICS dump 
(DSNC) and a subtask dump (system abend X'04E' with abend 
reason code '00C30001') have been requested. Register 9 in 
the CICS transaction dump contains the address of the CLOT. 


If the CLOT is valid, CLOTCCTE contains the CCT element 
address, and CCCTLOT contains the CLOT address. Use these 
pointers (CLOTCCTE and CCCTLOT) to verify the validity of the 
CLOT and CCTE. Both control blocks should contain 7 char- 
acter eye-catchers (DSNCLOT and DSNCCCT). If they are in 
error, check the application program for possible storage vio- 
lations. 


00030002 


Explanation: The CICS attachment facility was not able to start. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNCMSUB 


a End of Internal DB2 Information fee 


System Action: The CICS attachment facility terminates. 


Operator Response: Notify the system programmer. 


Problem Determination: A subtask dump (system abend 
X'04E' with abend reason code '00C30002') is requested. 
Within the dump, register 7 contains the address of load module 
DSNCRCT. In this load module, location CRCTCCTA contains 
the address of the CCCT control block (in subpool 99). The 
CCCT contains FRBRC1 and FRBRC2, which give the return 
code and reason code from the IDENTIFY process of subsystem 
DB2. These codes indicate why the CICS attachment facility 
was not allowed to start. 


00C30003 


Explanation: The CICS attachment facility could not complete a 
recover indoubt call because of the return and reason codes 
from DB2. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNCMSUB 


bee! End of Internal DB2 Information | 


System Action: The CICS attachment facility terminates. The 
unit of recovery (UR) is not resolved and remains indoubt. 


Operator Response: Notify the system programmer. 


Problem Determination: The return code from the recover 
indoubt process does not allow the CICS attachment facility to 
complete the unit of recovery (UR). If the UR included in the 
error is valid, an attempt should be made to resolve the UR 
manually, using the DB2 -RECOVER command. 


A subtask dump (system abend X'04E' with abend reason code 
'00C30003') is requested. Register 7 contains the address of 
the CRCT. Location CRCTCCTA in load module DSNCRCT con- 
tains the address of the CCCT control block (in subpool 99). 


The CCCT contains the FRB control block, which can be located 
by scanning the CCCT for the FRB character string eye-catcher. 
FRBRC1 and FRBRC2 contain the return code and reason code 
from DB2. 


A nonzero return code indicates problems specified by the 
reason code. Higher return codes (4, 8, and 12) indicate higher 
severity. The reason codes are explained in this book. 


Examine the MVS console for DB2 messages that may indicate 
any related errors. If an SVC dump was also taken, print it as 
well as the SYS1.LOGREC to obtain further diagnostic informa- 
tion. The CICS SYSTEM LOG may help to determine the final 
disposition of the indoubt unit of work. 


Register 6 in the subtask abend dump plus hexadecimal 20 con- 
tains the address of a 16-byte area that contains the network id 
(NID). The last 8 bytes of the NID contain the store clock value 
that was passed to DB2 by CICS to identify the logical unit of 
work (LUW). This value can be used to correlate the DB2 unit 
or recovery with the CICS logical unit of work. 


00030004 


Explanation: A thread subtask has failed because of a validity 
check failure of a transaction-related control block (CLOT). 


DB2 Codes 4-23 


00030005 — 00C30007 


Internal DB2 Information a 


This abend reason code is issued by the following CSECT(s): 
DSNCEXT3 


[ieee eee End of Internal DB2 Information ee 


System Action: The CICS attachment facility continues opera- 

tion; however, the one subtask is abended and a subtask dump 
(system abend X'04E' with abend reason code '00C30004') is 

requested. 


Because the CLOT contains an ECB on which the CICS applica- 
tion is waiting and this error indicates the CLOT has been over- 
laid, the effect on the CICS application is unpredictable. 


Operator Response: Notify the system programmer. 


Problem Determination: A CLOT control block does not pass 
validity checks. The most probable cause is that it has been 
overlaid by some user application. In the subtask abend dump, 
register 7 contains the address of CRCT. 


CRCTCCTA in CRCT contains the address of the CCCT, and 
CCCTLN in CCCT contains its length. Register 9 contains the 
CCCT element that was assigned to the application in error. 


This CCCT element address can be validated by ensuring that it 
lies within the CCCT. If the CCCT address is valid, CCCTLOT 
contains the address of the CLOT in error. To determine the 
source of the error, analyze the subtask dump and check the 
CICS master terminal for any storage violation messages. 


00C30005 


Explanation: The CICS attachment facility could not complete a 
commit or abort call for a transaction because of return codes 
from the application program support call. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNCEXT3 


[eae see End of Internal DB2 Information ee 


System Action: The CICS attachment facility continues opera- 
tion, but the one subtask abends with a subtask dump (system 
abend X'04E' with abend reason code '00C30005'). The CICS 
transaction that is associated with the abend is also abended 
with a CICS transaction dump 


Operator Response: Notify the system programmer. 


Problem Determination: The return code from the commit or 
abort does not allow the CICS attachment facility to complete 
the transaction’s unit of recovery. Register 7 in the subtask 
dump contains the address of the CRCT. 


Location CRCTCCTA in load module DSNCRCT contains the 
address of the CCCT control block (in subpool 99). CCCTCSUB 
in the CCCT contains the address of CSUB, the subtask work 
area. 


CSUB contains the FRB control block, which can be located by 
scanning CSUB for the FRB character string eye-catcher. 
FRBRC1 and FRBRC2 contain the return code and reason code 
from DB2. 


4-24 DB2 Messages and Codes 


A nonzero return code indicates trouble specified by the reason 
code. Higher return codes (4, 8, and 12) indicate higher 
severity. 


Refer to the reason code in “Section 4. DB2 Codes” on 

page 4-1. Ifthe reason code is not listed, it is an internal code 
that is useful only as a keyword. Refer to Section 2 of Diagnosis 
Guide and Reference and prepare a search argument, using 
the reason code as the appropriate keyword. If an SVC dump 
was also taken, print it and the SYS$1.LOGREC to obtain further 
diagnostic information. 


00C30006 


Explanation: The CICS attachment facility failed because of 
return codes from the MVS ATTACH macro while attempting to 
start a thread subtask. 


| Internal DB2 Information i 


This abend reason code is issued by the following CSECT(s): 
DSNCMSUB 


_—— End of Internal DB2 Information eee 


System Action: The CICS attachment facility terminates. 
Operator Response: Notify the system programmer. 


Problem Determination: A subtask dump (system abend 
X'04E' with abend reason code '00C30006') is requested. To 
determine why the ATTACH failed, use the MVS dump, MVS 
system trace, SYS1.LOGREC, and MVS console listing. Refer to 
the appropriate MVS publication to interpret the meaning of 
return codes from the MVS ATTACH macro. 


00030007 


Explanation: The start of the CICS attachment facility failed 
because of return codes while attempting to establish a shut- 
down listen exit with DB2. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNCMSUB 


{ End of Internal DB2 Information fei 


System Action: The CICS attachment facility terminates. 
Operator Response: Notify the system programmer. 


Problem Determination: The return code from the establish 
exit process does not allow the CICS attachment facility to start. 
A subtask dump (system abend X'04E' with abend reason code 
'00C30007 ') is requested. Register 7 contains the address of 
CRCT. 


Location CRCTCCTA in load module DSNCRCT contains the 
address of the CCCT contro! block (in subpool 99). The CCCT 
contains the FRB control block, which can be located by scan- 
ning the CCCT for the FRB character string eye-catcher. 
FRBRC1 and FRBRC2 contain the return code and reason code 
from DB2. 


A nonzero return code indicates trouble specified by the reason 
code. Higher return codes (4, 8, and 12).indicate higher 
severity. 


Refer to the reason code in “Section 4. DB2 Codes” on 

page 4-1. If the reason code is not listed, it is an internal code 
that is useful only as a keyword. Refer to Section 2 of Diagnosis 
Guide and Reference and prepare a search argument, using 
the reason code as the appropriate keyword. If an SVC dump 
was also taken, print it as well as the SYS1.LOGREC to obtain 
further diagnostic information. 


00030008 


Explanation: The start of the CICS attachment facility failed, 
because of reasons indicated by the return codes, while 
attempting to establish an ESTAE recovery exit. 


3 ~ Internal DB2 Information ee 


This abend reason code is issued by the following CSECT(s): 
DSNCMSUB 


(a End of internal DB2 Information fe 


System Action: An 04E abend subtask dump is taken, and the 
CICS attachment facility remains partially initialized. 


Operator Response: Notify the system programmer, and issue 
the DSNC STOP FORCE command. 


Probiem Determination: The return code from the ESTAE 
macro does not allow the CICS attachment facility to start. A 
subtask dump (system abend X'04E' with abend reason code 
'00C30008') is requested. To determine why the ESTAE failed, 
use the MVS dump, MVS system trace, SYS1.LOGREC, and MVS 
console listing. The MVS trace contains the return code from 
the ESTAE macro. Refer to the appropriate MVS publication for 
the meaning of return codes from the MVS ESTAE macro. 


00C30009 


Explanation: The CICS attachment facility failed because of the 
return code and reason code from DB2 for the SHOW INDOUBT 
units of recovery process. 


Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNCMSUB 


———e End of Interna! DB2 Information ae 


System Action: The CICS attachment facility terminates, and a 
subtask dump is requested. 


Operator Response: Notify the system programmer. 


Problem Determination: The return code from the SHOW 
INDOUBT process does not allow the CICS attachment facility to 
continue. A subtask dump (system abend X'04E' with abend 
reason code '00C30009') is requested. Register 7 contains the 
address of CRCT. 


Location CRCTCCTA in load module DSNCRCT contains the 
address of the CCCT control block (in subpool 99). The CCCT 
contains the FRB control block, which can be located by scan- 
ning the CCCT for the FRB character string eye-catcher. 
FRBRC1 and FRBRC2 contain the return code and reason code 
from DB2. 


00C30008 — 00C30011 


A nonzero return code indicates trouble specified by the reason 
code. Higher return codes (4, 8, and 12) indicate higher 
severity. Analyze the subtask dump. 


Refer to the reason code in “Section 4. DB2 Codes” on 

page 4-1. If the reason code is not listed, it is an internal code 
that is useful only as a keyword. Refer to Section 2 of Diagnosis 
Guide and Reference and prepare a search argument using the 
reason code as the appropriate keyword. If an SVC dump was 
also taken, print it and the SYS1.LOGREC to obtain further diag- 
nostic information. 


00C30010 


Explanation: A CICS attachment facility connection subtask 
issued an IDENTIFY call to DB2 that failed, indicating that DB2 is 
no longer active. 


| Internal DB2 Information = al: 


This abend reason code is issued by the following CSECT(s): 
DSNCEXT3 


ae ee End of Internal DB2 Information Spee 


System Action: A subtask dump is requested for the failing 
task thread, and the automatic STOP of the CICS attachment 
facility is initiated. 


Operator Response: Notify the system programmer. 


Problem Determination: Some other error, which is the source 
of the failure, has probably occurred prior to this action. Use 
the subtask dump, SYS1.LOGREC, MVS console listing, and any 
SVC dumps that may have been requested if DB2 failed. 


00C30011 


Explanation: The CICS attachment facility has detected that a 
resource control table entry (RCT) has been corrupted or over- 
laid since the CICS attachment facility was last started. 


| Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNCEXT3 


ee End of Internal DB2 Information eee eee 


System Action: The CICS attachment facility abends CICS task 
with a CICS transaction abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Stop and then restart the CICS 
attachment facility to refresh the resource control table (RCT). 


Problem Determination: Analyze the CICS dumps to determine 
which CICS trans-id and corresponding RCT entries were 
affected. The CICS transaction dump will contain the RCT 
storage at the time of the failure. Location CRCTAUWD in the 
affected RCT entry has been aitered since the CICS attachment 
facility was last started. This may be due to an application 
program modifying storage it does not own (a CICS storage vio- 
lation). 


DB2 Codes 4-25 


00C50001 — 00C50005 





TSO Attachment Facility Codes (X'C5") 


For the DSN command processor, the standard documentation 
to be collected is a SYSUDUMP and a printout of the DSNTRACE 
data set. The standard SPUF! documentation is a SYSUDUMP 
and a printout of the ISPF log for this session. A SYSUDUMP 
data set must be allocated in advance to collect your dump. A 
DSNTRACE data set must be allocated in advance to collect 
your DSN trace stream unless you are running in the back- 
ground, in which case the SYSTSPRT data set will contain the 
DSNTRACE output. ISPF normally runs with an active log data 
set. Refer to Section 5 of Diagnosis Guide and Reference for 
information about taking TSO dumps and for information about 
turning on the TSO attachment facility tracing facilities. ISPF 
suppresses dumps unless it is invoked with the TEST param- 
eter. 


In the TSO attachment facility, the user can control whether or 
not message IDs are displayed. To see them, type PROFILE 
MSGID. To suppress them, type PROFILE NOMSGID. 


The following abends can occur in the TSO attachment facility. 


00C50001 


Explanation: This is probably a DB2 subsystem error. 
DSNESM30 has detected an illegal value in the YTYPE portion 
of the SQLTYPE field of the SQLDA. 


ce Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNESM30 


te eee eee! End of Internal DB2 Information ee 


User Response: Ifthe problem persists, notify the system pro- 
grammer. 


System Programmer Response: The standard SPUFI documen- 
tation should be collected. Refer to “TSO Attachment Facility 
Codes (X'C5')” for information about obtaining dumps and dis- 
playing message IDs. 


Problem Determination: An illegal value was detected in the 
SQLTYPE field of the SQLDA. This may have been caused by 
this field being overlaid in error. To determine the source of 
the error, analyze the SQLDA in the storage dump. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 20. 


00050002 


Explanation: This is probably a DB2 subsystem error. 
DSNESM32 has detected an illegal value in the YTYPE portion 
of the SQLTYPE field of the SQLDA. This suggests that an 
illegal value was in the SQLTYPE field of the SQLDA. 


| Internal DB2 Information _—. ] 


This abend reason code is issued by the following CSECT(s): 
DSNESM32 


—— es End of Internal DB2 Information Bs 


User Response: If the problem persists, notify the system pro- 
grammer. 


System Programmer Response: The standard SPUFI documen- 
tation should be collected. Refer to “TSO Attachment Facility 
Codes (X'C5')” for information about obtaining dumps and dis- 
playing message IDs. 


Problem Determination: An illegal value was detected in the 
YTYPE of the SQLDA. This may have been caused by this field 
being overlaid in error. Analyze the SQLDA in the storage 
dump to determine the source of the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 20. 


00C50003 


Explanation: This could be either a user or a system error. 
SPUFI was unable to obtain the required storage via GETMAIN. 


| so  L Internal DB2 Information ~ == | 


This abend reason code is issued by the following CSECT(s): 
DSNESM10, DSNESM20 


ae End of Internal DB2 Information ete | 


System Action: SPUFI task abends. User returns to ISPF main 
menu. 


User Response: If the problem persists, notify the system pro- 
grammer. You may have to specify a larger machine size at 
logon time. 


System Programmer Response: If the problem persists, the 
standard SPUFI documentation should be collected. Refer to 
“TSO Attachment Facility Codes (X'C5')” for information about 
obtaining dumps and displaying message IDs. 


Problem Determination: Register 2 contains the amount of 
storage that was requested. Message DSNE392E, in the ISPF 
log data set, gives the name of the module that issued this 
abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 20. 


00050005 


Explanation: This could be either a user or a system error. 
The DYNALLOC SVC returned an unexpected return code when 
attempting to allocate a data set. 


es internal DB2 Information ~—_ i 


This abend reason code is issued by the following CSECT(s): 
DSNESM55 


———ae End of Internal DB2 Information be A 


System Action: The contents of the field are written to the ISPF 
log. 


User Response: Ifthe problem persists, notify the system pro- 
grammer. 


System Programmer Response: The standard SPUFI documen- 
tation should be collected. Refer to “TSO Attachment Facility 


DB2 Codes 4-27 


00C50007 — 00C50100 


Codes (X'C5')” for information about obtaining dumps and dis- 
playing message !Ds. 


Problem Determination: Message DSNE381E, in the ISPF log 
data set, gives the return code and reason code values 
returned from the dynamic allocation request. Refer to the 
appropriate MVS publication to determine the source of the 
error and analyze these values. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 20. 


00050007 


Explanation: This is probably an error in the SPUFI code. The 
field describing the record format of the output data set is not 
valid. 


i Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNESM55 


eee End of Internal DB2 Information ee oe. 


System Action: The contents of the field are written to the ISPF 
log. 


User Response: If the problem persists, notify the system pro- 
grammer. 


System Programmer Response: The standard SPUFI documen- 
tation should be collected. Refer to “TSO Attachment Facility 
Codes (X'C5')” on page 4-27 for information about obtaining 
dumps and displaying message IDs. 


Problem Determination: Message DSNE383A, in the ISPF log 
data set, gives the record format of the output data set that was 
determined to be in error. The output data set record format 
must be one of the following: F, FB, FBA, V, VB, or VBA. 


Collect the following diagnostic items listed in Appendix 8, 
“Problem Determination” on page X-5: 4, 20. 


00C50008 


Explanation: This could be either a user or a system error. 
The DYNALLOC SVC returned an unexpected return code when 
attempting to deallocate a data set. 


‘re Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNESM55 


aac aes End of Internal DB2 Information eee 


System Action: The contents of the field are written to the ISPF 
log 


User Response: [if the problem persists, notify the system pro- 
grammer. 


System Programmer Response: The standard SPUF! documen- 
tation should be collected. Refer to “TSO Attachment Facility 
Codes (X'C5')” on page 4-27 for information about obtaining 
dumps and displaying message IDs. 


Problem Determination: Message DSNE384E, in the ISPF log 
data set, gives the return code and reason code values 
returned from the dynamic allocation request. Analyze these 
values to determine the source of the error. 


4-28 DB2 Messages and Codes 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 20. 


00cs0009 


Explanation: This is probably caused by an error in the SPUFI 
code. The SQLCODE translation service (module DSNTIAR) has 
returned an unexpected return code. 


| Internal DB2 Information > =— 


This abend reason code is issued by the following CSECT(s): 
DSNESM40 


Lo End of Internal DB2 Information _ 


System Action: The contents of the field have been written to 
the ISPF log. 


User Response: If the problem persists, notify the system pro- 
grammer. 


System Programmer Response: The standard SPUF! documen- 
tation should be collected. Refer to “TSO Attachment Facility 
Codes (X'C5')” on page 4-27 for information about obtaining 
dumps and displaying message IDs. 


Problem Determination: Message DSNE387A, in the ISPF log 
data set, gives the return code value returned from DSNTIAR. 
The meanings of these return codes are: 


4 More data was availabie than could fit into the message 
area provided. 

8 The LRECL was not within the limits: 
72 > LRECL < 240 

12 The message area was not large enough. 
Message length > 240 

16 Error in message routine (IKJEFFO2). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 20. 


00050100 


Explanation: This is probably caused by an error in the DSN 
command processor code. Module DSNECP66 (in the DSN 
command processor) called module DSNTIAR to format an 
error message to explain an unexpected SQLCODE received by 
DCLGEN. DSNTIAR failed. 


| Internal DB2 Information = so) 


This abend reason code is issued by the following CSECT(s): 
DSNECP66 


oe ee End of Internal DB2 Information eae 


User Response: Ifthe problem persists, notify the system pro- 
grammer. 


System Programmer Response: The standard documentation 
should be collected, including a DSN trace stream. Refer to 
“TSO Attachment Facility Codes (X'C5')” on page 4-27 for 
information about obtaining dumps and displaying message 
IDs. 


Problem Determination: Message DSNEOO04E in the output 
gives the return code value returned from DSNTIAR. For an 
explanation of these return codes, see abend reason code 
‘00C50009'. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 19. 


00C50101 


Explanation: The user has entered the ABEND subcommand of 
the DSN command processor. This causes a X'04E' abend and 
a dump to be requested. In order to retain the dump, you must 
have previously allocated a SYSUDUMP or SYSADUMP data 
set. The ABEND subcommand can be useful for debugging. 


‘ae = Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNECP19 


LT End of Interna! DB2 Information _ 


System Action: A X'04E' abend results, and a dump is 
requested. 


System Programmer Response: The standard documentation 
may be needed. Refer to “TSO Attachment Facility Codes 
(X'C5')” on page 4-27 for information about obtaining dumps 
and displaying message IDs. 


Problem Determination: Collect the following diagnostic items 


listed in Appendix B, “Problem Determination” on page X-5: 4,. 


19. 


00C50102 


Explanation: An error probably occurred in DB2 while it 
attempted to process an IDENTIFY request from the DSN 
command processor. DSN received an unexpected return code 
(FRBRC1 or FRBRC2) from DB2. - 


= internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNECP 12 


[ee seat as End of Internal DB2 Information i etees Fon | 


System Action: immediately after writing this message, DSN 
abends with an abend code of X'04E' and an abend reason 
code of '00C50102'. 


User Response: If the problem persists, notify the system pro- 
grammer. 


System Programmer Response: See the Problem Determi- 
nation section of this message. 


Problem Determination: Rerun the job with DSN tracing turned 
on. You may need a SYSUDUMP from the TSO address space. 
You probably need a DB2 dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for problem analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 19. 


00050103 


Explanation: An error probably occurred in DB2 while it 
attempted to process an ESTABLISH EXIT request from the DSN 
command processor. DSN received an unexpected return code 
(FRBRC1 or FRBRC2) from DB2. 


00050101 — 00050108 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNECP12 


ee eee nee End of Internal DB2 Information _ 


System Action: Immediately after writing this message, DSN 
abends with an abend code of X'04E' and an abend reason 
code of '00C50103'. 


User Response: Ifthe problem persists, notify the system pro- 
grammer. 


System Programmer Response: See the Problem Determi- 
nation section of this message. 


Problem Determination: Rerun the job with DSN tracing turned 
on. You may need a SYSUDUMP from the TSO address space. 
You probably need a DB2 dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for problem analysis procedures. 


Coltect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 19. 


00050104 


Explanation: An error probably occurred in DB2 while it 
attempted to process a CREATE THREAD request from the DSN 
command processor. DSN received an unexpected return code 
(FRBRC1 or FRBRC2) from DB2. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNECP13 


L End of Internal DB2 Information eee ed 


System Action: immediately after writing this message, DSN 
abends with an abend code of X'04E' and an abend reason 
code of '00C50104'. 


User Response: Ifthe problem persists, notify the system pro- 
grammer. 


System Programmer Response: See the Problem Determi- 
nation section of this message. 


Problem Determination: Rerun the job with DSN tracing turned 
on. You may need a SYSUDUMP from the TSO address space. 
You probably need a DB2 dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for problem analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 19. 


00050108 


Explanation: An error probably occurred in DB2 while it 
attempted to process a BIND, REBIND, or FREE request from 
the DSN command processor. DSN received an unexpected 
return code (FRBRC1 or FRBRC2) from DB2. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNECP30 


(es et End of Internal DB2 Information ates a] 


DB2 Codes 4-29 


00C50109 — 00050111 


System Action: Immediately after writing this message, DSN 
abends with an abend code of X'04E' and an abend reason 
code of '00C50108'. 


User Response: If the problem persists, notify the system pro- 
grammer. 


System Programmer Response: See the Problem Determi- 
nation section of this message. 


Problem Determination: Rerun the job with DSN tracing turned 
on. You may need a SYSUDUMP from the TSO address space. 
You probably need a DB2 dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for problem analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 19. 


00C50109 


Explanation: An error probably occurred in DB2 while it 
attempted to process a TERMINATE request from the DSN 
command processor. DSN received an unexpected return code 
(FRBRC1 or FRBRC2) from DB2. 


| Internal DB2 Information ~ ] 


This abend reason code is issued by the following CSECT(s): 
DSNECP18 


er End of interna! DB2 Information ee 4 


System Action: Immediately after writing this message, DSN 
abends with an abend code of X'04E' and an abend reason 
code of '00C50109'. 


User Response: If the problem persists, notify the system pro- 
grammer. 


System Programmer Response: See the Problem Determi- 
nation section of this message. 


Problem Determination: Rerun the job with DSN tracing turned 
on. You may need a SYSUDUMP from the TSO address space. 
You probably need a DB2 dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for problem analysis procedures. 


Cotlect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 19. 


EN 
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00C50110 


Explanation: This is a DSN command processor error. It 
occurs when the DSN STAX routine (DSNEBP01) is entered and 
the DSN control blocks cannot be located; the AEPLUSR field 
did not contain the CIB address. 


| Internal DB2 Information = 
This code is issued by the following CSECT(s): DSNECPO1 


lig Sos End of Internal DB2 Information | 


Severity: 4 
System Action: The DSN command processor abended. 


User Response: If you allocated a SYSUDUMP or SYSABEND 
dump data set, collect the dump. Otherwise, allocate 
SYSUDUMP and DSNTRACE data sets, turn on DSN tracing, and 
try to recreate the error. Save these data sets. 


00050111 


Explanation: Your application program made an Instrumenta- 
tion Facility Component Application Program interface (instru- 
mentation facility interface) call to DB2 language interface 
module DSNELI, but your application program was not running 
under the DSN command processor. You must run all applica- 
tion programs using DSNELI under DSN. To do this, first issue 
the DSN command, then start your application using the RUN 
subcommand of the DSN command processor, and finally, when 
the application completes, stop DSN with an END subcommand. 


———— internal DB2 Information et 
This reason code is issued by the following CSECT(s): DSNELI 


{| End of Internal DB2 information — ee 


System Action: Control returns to the application. Your appli- 
cation can continue processing. Further attempts at instrumen- 
tation facility interface (IFI) calls will continue to produce this 
return and reason code. 


User Response: Rerun your application under the DSN 
command processor. 


Operator Response: Notify your system programmer. 


System Programmer Response: Modify the job to invoke DSN. 
Initiate the application program using the RUN subcommand of 
the DSN command processor. 





Precompiler Codes (X'C8') 


Abends in the precompiler are not intercepted via 
ESTAE, so standard system abends may occur. 
The SYNAD exit is not used, so I/O errors cause 
$001 or S002 abends. SO4E abends are generated 
for precompiler internal errors. Following is a list 
of reason codes. 


00C8901X 


Explanation: An internal precompiler/parser consistency 
check failed. An SO4E abend will occur. The error type and 
reason code will be found in register 15 of the dump. 


In the reason code, X is one of the following: 


1 The parser received a token code of 0 from the lexical 
scan. Lexical scan refers to a scan of words rather than 
syntax. 

An error in storage suballocation control blocks. 

An error in storage suballocation request. 

An error in pointer structures. 

On BIND or REBIND, a host variable could not be found. 


anh wh 


00C8901X — 00C89041 


| ” Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 


DSNHCORE DSNHDBRM = DSNHLIST 
DSNHMAIN DSNHPARS DSNHSMUD 
DSNHSMUT DSNHTEXT DSNHXLTR 


{ End of Internal DB2 Information Pee 


User Response: Notify the system programmer. 


System Programmer Response: Obtain the SVC dump anda 
copy of the application program source. If the abend reason 
code is 00C89015, obtain a copy of the DBRM being bound 
(IEBCOPY). 


00C89041 


Explanation: More storage is needed, but could not be 
obtained during the precompiler execution. An SO4E abend will 
occur. The error type and reason code will be found in register 
15 of the dump. 


a ~ {internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNHCORE 


ee ee End of Internal DB2 Information eee 


User Response: The storage required for the current state- 
ment could not be acquired or exceeds the maximum (64K 
bytes) for a single request. If the region is full, check whether 
the region can be expanded. If it cannot be expanded, the SQL 
statement is too large to be processed. 


System Programmer Response: See User Response. 


DB2 Codes 4-31 


00C90033 — 00C90081 


Data Manager Reason Codes (X‘'C9') 


00C90033 


Explanation: An attempt has been made to free a cache for a 
plan in the EDM Pool. However, the cache does not exist. 


—— are Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNGEFBL 


{Ss End of Internal DB2 Information 


System Action: The requested operation is not performed. 


User Response: Verify that the indicated plan has the specific 
cache defined. 


00C90034 


Explanation: A cache is requested for a plan whose SKCT 
directory does not support caching. 


[7 = Internal DB2 Information | 


This abend reason code is issued by the following CSECTS(s): 
DSNGELBL 


| send of internal DB2 Information ___ | 


System Action: The requested operation is not performed. 


User Response: !f caching is desired for the given plan, issue 
a REBIND for the plan. 


00090035 


Explanation: A new cache has been created for the plan and 
needs to be formatted for use. 


a 7 ~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNGELBL 


te ee End of internal DB2 Information | 


00090036 


Explanation: The request to create a cache for the plan was 
issued. However, the EDM Pool resource has been exhausted. 


| etsy ~~ internal DB2 Information ~——_———— = 


This abend reason code is issued by the following CSECTS(s): 
DSNGELBL 


eo End of Internal DB2 Information feet 


System Action: The requested operation is not performed. 


User Response: Invoke the application again. If after several 
attempts there is still not enough space, follow the recommen- 


dations listed for code 00C90089 for reducing EDM storage 
requirements. 


00C90080 


Explanation: An attempt was made to allocate to a resource 
with the capability of performing update operations. However, 
the resource has already been started for read-only access. 


‘a —— Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNIDBAT 


es End of Internal DB2 information aes 


System Action: The allocation process is not allowed. 


User Response: Determine when the resource is started for 
read/write access, and rerun the job. 


Operator Response: If this reason code appears in message 
DSNT500!, determine whether the named resource should be 
started for read-only access. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT5001 is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1 or to the 
description of the DSNT500! message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C90081 


Explanation: An attempt was made to allocate a resource that 
is stopped for all access. 


ae ~~~ Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNIDBAT 


Ls End of Internal DB2 Information ___——_| 


System Action: The allocation process is not allowed. 


User Response: Determine when the resource is no longer 
stopped, and rerun the job. 


Operator Response: If this reason code appears in message 
DSNT5001, determine whether the resource should be stopped. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 or -923 is issued, and/or 
message DSNT5001 is issued. For more information, refer to the 
SQL code in “Section 2. SQL Return Codes”, or to the 
description of the DSNT5001 message in “Service Controller and 
Installation Messages (DSNT...)”. 


DB2 Codes 4-33 


00C90082 — 00C90085 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C90082 


Explanation: An attempt was made to allocate to a resource 
that is allocated to a DB2 utility function. 


[ ~~~ _ Internal DB2 Information se 


This reason code is issued by the following CSECT(s): 
DSNIDBAT 


ee eas End of Internal DB2 Information eee 


System Action: The allocation process is not allowed. 


User Response: Determine when the resource is available, 
and rerun the job. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 or -923 is issued, and/or 
message DSNT500I is issued. The resource allocated to the 
DB2 utility function may be either in use by a utility or reserved 
for a utility. (If the resource is reserved, but not currently in 
use, for a utility, the -DISPLAY UTILITY command will indicate 
that no utilities are operating on that object.) To access a 
resource that is reserved for a utility, use the -START DATA- 
BASE command with the FORCE parameter. For more informa- 
tion, refer to the SQL code in “Section 2. SQL Return Codes” on 
page 2-1, or to the description of the DSNT500I message in 
“Service Controller and Installation Messages (DSNT...)” on 
page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00090083 


Explanation: An attempt was made to allocate to a resource 
with the capability of performing update operations. However, 
the resource is already allocated to a DB2 utility function that 
allows other users to have read-only access. 


[he Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNIDBAT 


[ End of Internal DB2 Information eg alt Fl 


System Action: The allocation process is not allowed. 


User Response: Determine when the resource is started for 
read/write access, and rerun the job. 


4-34 DB2 Messages and Codes 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNTS500I is issued. The resource allocated to the DB2 utility 
function may be either in use by a utility or reserved for a 
utility. (If the resource is reserved, but not currently in use, for 
a utility, the -DISPLAY UTILITY command will indicate that no 
utilities are operating on that object.) To access a resource 
that is reserved for a utility, use the -START DATABASE 
command with the FORCE parameter. For more information, 
refer to the SQL code in “Section 2. SQL Return Codes” on 
page 2-1, or to the description of the DSNT500! message in 
“Service Controller and Installation Messages (DSNT...)” on 
page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C90084 


Explanation: The temporary file with the page size shown in 
NAME is not available. An error was detected either during the 
opening of the page set or during the formatting of the header 
and the space map pages of the page set. 


| Internal DB2 Information ee 


This reason code is issued by the following CSECT(s): 
DSNIWKFL, DSNITFFS 


Lo End of Internal DB2 Information See ee tl 


System Action: DB2 startup/restart continues if this reason 
code appears in a DSNT5001 message issued during the startup 
process. 


lf the reason code appears in a DSNTS500I message issued 
during the -START DATABASE command, the request fails. In 
either case, the temporary file function does not allocate any 
temporary file on the page set. 


User Response: Deiete and redefine the temporary data set(s) 
in question, and then issue the -START DATABASE command to 
start the temporary file. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT5001 is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT5001 message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 4, 5, 10, 31. 


o0ocs00ss 


Explanation: The limit of 255 temporary files per transaction 


has been reached. 


[ 2 ~ Internal DB2 Information ~~" ————— Al 


This reason code is issued by the following CSECT(s): 
DSNIWCTD 


bic pia ated End of Internal DB2 Information | 


System Action: The request to create a new temporary file is 
not allowed. 


User Response: Rewrite the SQL statement that caused the 
problem. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT5001I is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT500! message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SOWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 16, 31, 51. 


00090086 


Explanation: An attempt was made to allocate a resource that 
is started for DB2 utility access only. 


el aa Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNIDBAT 


nee ae End of Internal DB2 Information eee 


System Action: The allocation process is not allowed. 


User Response: Determine when the resource is available for 
use, and rerun the job. 


Operator Response: If this reason code appears in message 
DSNTS500!, determine whether the resource should be started 
for utility access only. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 or -923 is issued, and/or 
message DSNT5001 is issued. For more information, refer to the 
SQL code in “Section 2. SQL Return Codes” on page 2-1, or to 
the description of the DSNT500I message in “Service Controller 
and Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C90087 


Explanation: A page that is marked as 'broken' has been 
read. The database, table space or index space, and the page 
number are identified in NAME. 


00C90086 — 00C90088 


Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNIADBR 


eae Sec meaes End of Internal DB2 Information _ id 


System Action: The data manager function that detected this 
condition returns a resource not available condition to its 
invoker. Access to the page is not be permitted until it is 
repaired. 


User Response: If the TYPE is '00000300', examine the name 
to determine if the page is in an index space or a table space. 
Use the REPAIR utility to fix the broken page. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 or -923 is issued, and/or 
message DSNT5001 is issued. For more information, refer to the 
SQL code in “Section 2. SQL Return Codes” on page 2-1, or to 
the description of the DSNT500I message in “Service Controller 
and Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00090088 


Explanation: The resource identified by NAME in message 
DSNT5001 is involved in a deadlock condition. 


| Internal DB2 Information Se 


This reason code is issued by the following CSECT(s): 
DSNILMCL 


are End of Internal DB2 Information eres 


System Action: The requested operation is not performed. 
User Response: Rerun the application. 


System Programmer Response: If the deadlock condition 
becomes chronic, examine the mix of applications running to 
determine why the deadlock is occurring. Either eliminate the 
cause of the deadiock, or revise the application. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -911, -913, or -923 is issued, 
and/or message DSNT5001 is issued. For more information, 
refer to the SQL code in “Section 2. SQL Return Codes” on 
page 2-1, or to the description of the DSNT5001 message in 
“Service Controller and Installation Messages (DSNT...)” on 
page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 17, 31, 34, 35. 


DB2 Codes 4-35 


00C90089 — 00C9008C 


00C90089 


Explanation: The environmental descriptor manager (EDM) 
function of the data manager subcomponent did not have 
enough storage in its pool to support the retrieval of object with 
ID 'object id' (DBD ID or SKCT plan name). The object can be 
either a database descriptor (DBD) or a skeleton cursor table 
(SKCT). 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNGEELC, DSNGESLC, DSNGEDST, DSNGEDLC, DSNGEFSP 


a End of Internal DB2 Information _ 


System Action: The requested operation is not performed. 


User Response: Invoke the application again. If, after several 
attempts, there is still not enough space, the following actions 
can be taken to reduce EDM storage requirements: 


e Reduce the number of concurrent users using DB2. 

* Try reducing the number of SQL statements in the plan and 
rebind. 

¢ Try to simplify the database design—for example, reduce 
the number of partitions in the database. 


To increase the EDM pool size definition, on the UPDATE install 
panels: 


¢ If EDM storage shortage is a recurring problem, change the 
installation parameters that affect the size of the EDM 
pool—that is, increase the number of concurrent users and 
the number of currently active databases, then restart DB2. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 or -923 is issued, and/or 
message DSNT500I is issued. For more information, refer to the 
SQL code in “Section 2. SQL Return Codes” on page 2-1, or to 
the description of the DSNT500!I message in “Service Controller 
and Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00CS008A 


Explanation: The database procedure installation exit identi- 
fied by NAME could not be loaded for execution. 


| ~~~ Internal DB2 Information ae a 


This reason code is issued by the following CSECT(s): 
DSNIREDR, DSNIENSR 


ocr eee End of Internal DB2 Information pete eee 


System Action: The requested operation is not performed. 


User Response: Determine the reason the installation exit 
could not be loaded, correct the problem, and rerun the job. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
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DSNT500! is issued. For more information, refer to the SQL 
code in “Section 2. SQL.Return Codes” on page 2-1, or to the 
description of the DSNT500!1 message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C9008B 


Explanation: An attempt was made to create a database, but 
no DBIDs are available; that is, the system limit has been 
reached. 


| Ty internal DB2 Information ~ San 


This reason code is issued by the following CSECT(s): 
DSNGDCID 


oer End of internal DB2 Information rar 


System Action: The create is not allowed. 


User Response: DROP all unused databases, and rerun the 
job. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT500I is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT500I message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00cs9008sC 


Explanation: An attempt was made to allocate or bind to a par- 
titioned table space for which no clustering index was defined. 


| ‘ Internal DB2 Information ~~ ae 


This reason code is issued by the following CSECT(s): 
DSNISPSC, DSNICUBC, DSNIALLC 


{| End of Internal DB2 Information _____—_| 


System Action: The bind or allocation process is not allowed. 


User Response: Define the clustering index for the partitioned 
table space, and rerun the job. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT500! is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT500I message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 14, 16, 31, 32, 34. 


00C9008D 


Explanation: An attempt was made to bind to a table space 
that had an incomplete clustering definition. 


a ~~ Internal DB2 Information 7 


This reason code is issued by the following CSECT(s): 
DSNISPSC, DSNIPSFI 


reer ethene, End of internal DB2 Information ee 


System Action: The bind process is not allowed. 


User Response: Complete the clustering definition for the table 
space, and rerun the job. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT5001 is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT500I message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 14, 16, 31, 32, 34. 


00CS9008E 


Explanation: A lock request for the resource identified by 
NAME could not be granted, and the request waited for a period 
longer than the maximum specified by the installation. 


[ TS Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNILMCL 


[hee ce eae oa End of Internal DB2 Information ee 


System Action: The data manager function that detected this 
condition returns 'RESOURCE NOT AVAILABLE ' to its invoker. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904, -911, -913, or -923 is 
issued, and/or message DSNT500I is issued. For more informa- 
tion, refer to the SQL code in “Section 2. SQL Return Codes” on 
page 2-1, or to the description of the DSNT5001 message in 
“Service Controller and Installation Messages (DSNT...)” on 
page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


00C9008D — 00C90090 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 17, 31, 34, 35. 


00C9008F 


Explanation: The limit of a database descriptor’s size (DBD) 
has been reached. 


r = Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNGDCPD 


a eet End of Internal DB2 Information eae ee 


System Action: The request to create/alter a database object 
is not allowed. 


User Response: Create the database object in a different data- 
base or drop unused database objects from the database. If 
you drop an object that is an index or a table space, the space 
becomes available in the DBD as soon as the drop is com- 
mitted. !f you drop an object that is a table, the space in the 
DBD is made available only after all of the following: 


¢ The DROP is committed. 


¢ The DB2 REORG is run on the table space (if the table 
space in which the dropped table was defined is nonseg- 
mented). 


¢ MODIFY is run to delete all image copies of data that con- 
tains rows of the dropped table, that is, copies that were 
taken before the REORG (nonsegmented table spaces) or 
before the DROP (segmented table spaces). 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT500I is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT500! message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C90090 


Explanation: The table space or index space could not be 
started, because there is an outstanding start that must be 
resolved before the start is allowed. 


r ~~ Internal DB2 Information ~_ | 


This reason code is issued by the following CSECT(s): 
DSNILMCL 


ee ees End of Internal DB2 Information sree =e 


System Action: The START operation is not performed. 


User Response: Wait for all starts to the database to complete 
before reissuing the -START command. 


Problem Determination: The requested operation is not per- 
formed. Message DSNIO002I is issued. For more information, 
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00C90091 — 00C90093 


refer to the description of this message in “Data Manager Mes- 
sages (DSNI...)” on page 3-69. If the problem persists after all 
starts are completed, gather diagnostic information to pursue 
the problem. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31, 32. 


00C90091 


Explanation: The table space or index space could not be 
started, because there is an outstanding indoubt UR that must 
be resolved before the start is allowed. 


| = a Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNILSTS 


Meee et End of Internal DB2 Information eras | 


System Action: The START operation is not performed. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNT500! is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT500! message in “Service Controller and 
installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31, 32. 


00C90092 


Explanation: The data manager (DM) subcomponent received 
an out-of-storage indication from IRLM resulting from a lock, 
unlock, or lock change request. 


[ ” Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNILMCL 


Ph eaten te ee End of Internal DB2 Information ee eel 


System Action: A record is written to SYS1.LOGREC. No dump 
is requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: !RLM has exhausted the 
amount of virtual storage available to it to represent locks. 
insufficient virtual storage remains to accomplish this request. 
Refer to Section 2 (Volume 1) of Administration Guide for the 
IRLM procedure to determine the amount of storage space 
available. 


The current mix of transactions has caused all available 
storage to be used. You may find the number of locks held by a 
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particular transaction by either using the DB2 performance 
trace facility or by performing IRLM tracing. Refer to Section 6 
(Volume 2) of Administration Guide for information pertaining to 
the DB2 performance trace facility. Refer to Section 5 of Diag- 
nosis Guide and Reference for information pertaining to IRLM 
trace. 


Determine what transactions were running and the number of 
locks they held. You may want to schedule some of these trans- 
actions at a different time. 


You can reduce the total number of page locks that applications 
concurrently hold by changing the locking protocol on one or 
more table spaces. Use one of the following: 


e ALTER TABLE SPACE...LOCKSIZE ANY 
¢ ALTER TABLE SPACE...LOCKSIZE TABLE SPACE 
e LOCK TABLE statements 


If application logic permits, reduce the number of page locks 
concurrently held for SELECT statements by rebinding applica- 
tion plans with isolation level of cursor read stability instead of 
repeatable read. 


Refer to Chapter 5 of SQL Reference for further information. 


Problem Determination: An SQL return code of -904 or -923 is 
issued, and/or message DSNT5001 is issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 17, 31, 34, 35. 


00C90093 


Explanation: An error occurred in IRLM. 


| ev ~ Internal DB2 Information ~ = aa 


This reason code is issued by the following CSECT(s): 
DSNILMCL 


——— End of Internal DB2 Information pees ae 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: Examine SYS1.LOGREC for a 
preceding error related to IRLM. 


Problem Determination: An SQL return code of -904 or -923 is 
issued, and/or message DSNT500! is issued. 


SYS1.LOGREC contains the same diagnostic information in the 
variable recording area (VRA) as shown for abend reason code 
'00C90101'. For information about finding the SDWA, refer to 
Section 5 of Diagnosis Guide and Reference. The first four 
bytes of CTSIWHY contain the return code from the IRLM func- 
tion. The fifth byte of CTSIWHY contains the request code, as 
follows: 


X'02' Lock 
X'03' Unlock 
X'04' Change 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 


VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 17, 31, 34, 35. 


00C90094 


Explanation: A data set exists in a state that is different from 
what DB2 expects. Possible causes are that a data set has 
been deleted and redefined without DB2’s knowledge, or that a 
previous DB2 failure may have occurred involving the data set. 


| 3 = Internal DB2 Information =~ —<—~C~C:*# ~—¢ 


This reason code is issued by the following CSECT(s): 
DSNIBMCL 


Ieee End of Internal DB2 Information ee 


System Action: The requested action is not performed. if the 
invoker of this module (DSNIBMCL) abends, a record is written 
to SYS1.LOGREC, and the invoker probably initiates a dump. If 
the invoker does not abend, no record is written to 
SYS1.LOGREC, and no dump is requested. If this occurs, an 
SQL return code is issued, and/or message DSNT5001 is issued. 
If the invoker of DSNIBMCL is not a utility, the data set is placed 
in a stopped status. 


Operator Response: Notify the system programmer. 


System Programmer. Response: !f you do not have the current 
level of the data set, you must perform DB2 recovery to return 
the data set to its expected state. See the Problem Determi- 
nation section of this message for procedures to determine the 
name of the data set to be corrected. Use the DISPLAY 
command to check the status of the data set. If the data set is 
stopped, use the START command before performing recovery. 


Problem Determination: For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
the description of the DSNT500!I message in “Service Controller 
and Installation Messages (DSNT...)” on page 3-121. 


This error is detected at a time when the specific name of the 
data set involved cannot be determined by DB2. However, the 
SQL code or message DSNT500I provides the name of the table 
space or index space in which the data set resides. When the 
table or index space consists of a single data set, this is spe- 
cific. Otherwise, the system programmer must find the partic- 
ular data set within the table or index space. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 10, 31, 32, 34. 


00C90095 


Explanation: An attempt was made during DB2 restart to 
access a page in order to apply a log record but DB2 was 
unable to access the page. This abend reason code appears as 
the reason code in message DSNIO01I. 


00C90094 — 00C90096 


| internal DB2 information | 


This abend reason code is issued by CSECT(s): DSNIBMOC, 
DSNIIMPD 


— End of Internal DB2 Information tee 


System Action: The restart of the named table space or index 
space is deferred by the subsystem. 


Operator Response: Notify the system programmer. 


System Programmer Response: Correct the problem, and then 
use either -START DATABASE or the RECOVER utility to make 
the table space or index space available. 


Problem Determination: Examine previous messages on the 
console to determine why DB2 could not access the page. One 
possible reason is that a back-level pack was mounted. That is, 
the page to which the log record applies was not yet formatted 
by VSAM. DB2 does not extend data sets during restart. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 12, 31, 32. 


00C90096 


Explanation: The page lock on the page or subpage identified 
by NAME in message DSNT500! caused the total number of 
page locks concurrently held to reach the installation maximum 
number of page locks (NUMLKUS) allowed for a single agent in 
the system. 


| Internal DB2 Information = | 


This reason code is issued by the following CSECT(s): 
DSNILMCL 


Nes Sa ae End of Internal DB2 Information eee | 


System Action: The operation that encountered this condition 
is not executed. Any database updates are backed out. Ifa 
utility job encountered this condition, the utility is stopped. 


User Response: Rerun the application after correcting the 
cause of this resource unavailable condition. 


Programmer Response: The programmer may reduce the total 
number of page locks that the application concurrently holds by 
changing the locking protocol on one or more of the table 
spaces to table space level locking. To do this, use the ALTER 
... LOCKSIZE TABLE SPACE or LOCK TABLE statements. 


The application may be reviewed to see if a different choice of 
SQL statements can be used to perform the same operation 
with less concurrent access to multiple tables with page 
locking. 


If application logic permits, reduce the number of page locks 
concurrently held for SELECT statements by rebinding the 
application plan with isolation level of cursor stability instead of 
repeatable read. 


System Programmer Response: If the application should be 
able to run with the current page locking protocol and SQL 
statements, increase the NUMLKUS value for the installation to 
allow a higher limit of page locks to be concurrently held by a 
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00C90097 — 00C90099 


single application. If a utility job has encountered this resource 
unavailable condition, the NUMLKUS value must be increased 
to accommodate the utility, because utilities are programmed to 
use the minimum number of page locks possible. Refer to 
Section 6 (Volume 2) of Administration Guide for further infor- 
mation about choosing the value for NUMLKUS. 


Operator Response: /f a utility job encountered this resource 
unavailable condition, terminate the utility and restart it after 
the cause of the resource unavailable condition has been cor- 
rected. 


Problem Determination: An SQL return code of -904 and 
message DSNT500I are issued. For more information refer to 
the SQL code in “Section 2. SQL Return Codes” on page 2-1 or 
the DSNT500! message in “Service Controller and Installation 
Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C90097 


Explanation: An attempt was made to allocate to a table space 
with the capability of performing update operations. However, 
the table space has been marked for image copy required, and 
updates are not allowed. This condition will occur as a result of 
any of the following: 


¢ Running a REORG or LOAD utility against the table space 
without running a copy which specifies FULL YES. 

¢ Execution of a RECOVER utility which specifies TORBA to 
TOCOPY options, without following it with the required 
COPY utility. 

¢ Execution of a -TERM UTILITY command against a COPY 
utility which has failed during the copy phase or was active 
in the copy phase. Until the COPY is done, SQL updates 
cannot be allowed without compromising the integrity of the 
data. 

¢ Execution of a MODIFY utility after all back up copies of the 
table space or data set have been deleted from the 
SYSCOPY table. 


[ - Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNIDBAT 


[ies epee End of Internal DB2 Information eed 


System Action: The allocation process is not allowed. 


User Response: Run the COPY utility. However, if the table 
space is to be used for read-only access, or if recoverability of 
the data is not required, instead of taking a full image copy you 
can run the REPAIR utility and request that the image copy 
required condition be removed. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNTS500I is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1 or to the 
description of the DSNT500I message in “Service Controller and 
installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
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icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31. 


00C90098 


Explanation: An attempt was made to increase the utility in 
process read only or write access counts beyond the maximum 
(255) allowed. 


| Internal DB2 Information = | 
This abend reason code is issued by CSECT(s): DSNIPSUI 


pee End of Interna! DB2 Information _ 


User Response: Use the the -DISPLAY UTILITY command to 
determine how many utility jobs are currently active. Ifa 
number of utility jobs are active but not in the stopped state, 
notify the system programmer. If the utility jobs are running, 
resubmit your job after they have completed. 


System Programmer Response: Determine why active utilities 
are in the stopped state. The -TERM UTILITY command can be 
used to terminate utilities and reduce the UIP (utility in process) 
counts. If no active utilities are indicated, then use the 
-DISPLAY DATABASE command to determine if UIP counts are 
still present. The -START DATABASE command using ACCESS 
FORCE may be used to reset the count to zero. 


Problem Determination: Message DSNT500I is issued. For 
more information, refer to the explanation of message 
DSNT500! in the Service Controller Messages section of this 
book. 


00C90099 


Explanation: An attempt was made to load data into a partition, 
but the partition is full. Based on the High Key value specified 
in the Index for each partition, utilities instructed Data Manager 
to load a record into the proper partition. This required Data 
Manager to build a new page with a page number one higher 
than the last page in the partition. However, this new page is in 
the next partition. 


a Internal DB2 Information ss 
This abend reason code is issued by CSECT(s): DSNILPG 


oe End of Internal DB2 Information feet 


System Action: The requested action is not performed. 


User Response: Redefine the High Key values in the Index and 
retry the load. 


Operator Response: Notify the system programmer. 


System Programmer Response: Use the -TERM UTILITY 
command to terminate the load utility and reduce the UIP (utility 
in process) counts. 


Problem Determination: For more information, refer to the 
explanation of message DSNT5001 in the Service Controller 
Messages section of this book. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 31, 36. 


0OCS009A 


Explanation: An attempt was made to create a system data- 
base which, according to the DBID space map, has already 
been created. However, the catalog shows the database was 
not created. This discrepancy between the catalog and the 
space map for DBIDs may be due to an unsuccessful migration. 


| 7) — =? —— Internal DB2 Information gi 


This abend reason code is issued by the following CSECT(s): 
DSNGDCID 


ees End of Internal DB2 Information | 


System Action: Database is not created. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Drop the database, then 
create it (using DROP and CREATE commands). If this fails to 
resolve the error, follow the steps in problem determination. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 is issued, and/or message 
DSNTS500I is issued. For more information, refer to the SQL 
code in “Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT500I message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK13, VRARRK14, and 
VRARRK15. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about VRA data and finding the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 31, 37, 38. 


00C9009B 


Explanation: An attempt was made to load data into a linear 
table space, but the table space is full. A linear table space can 
contain a maximum of 64 gigabytes of data. 


| Internal DB2 information al 
This abend reason code is issued by CSECT(s): DSNILPG 


End of Internal DB2 Information ens | 


System Action: The requested action is not performed. 


User Response: Use the -TERM UTILITY command to terminate 
the load utility and reduce the utility in process (UIP) counts. 
Use ALTER TABLE SPACE to reduce the amount of free space 
within a page (PCTFREE) and the number of free pages within 
the table space (FREEPAGE) and retry the load. If itis a 
resume load job, reorganize the table space before rerunning 
the load. . 


Problem Determination: For more information, refer to the 
explanation of message DSNTS500I in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 31, 36. 


00CS009A — 00C9009D 


00cs00sC 


Expianation: An attempt was made to insert data into a parti- 
tioned table space or index space, but the partition is full. For 
table space partition, the data to be inserted is based on the 
high-key value specified in the cluster index. If it is an index 
space partition, the index entry to be inserted is also based on 
the high-key value associated with the index. 


[ => -— internal DB2 Information 


This abend reason code is issued by CSECT(s): DSNISMPI, 
DSNISMXP 


| End of Internal DB2 Information 


System Action: A ‘resource not available' code is returned to 
the end user and the requested action is not performed. The 
SVC dump and the SYS1.LOGREC recording are not requested. 


User Response: Notify the system programmer to redefine the 
partitions and rerun the job. 


System Programmer Response: Refer to Section 5 (Volume 2) 
of Administration Guide to redefine a partition. The partition 
that is required to be redefined is identified in the DSNT5001 
message. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: For more information, refer to the 
explanation of message DSNT500! in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 36. 


00cs00sD 


Explanation: An attempt was made to insert data into a linear 
table space or index space, but the table space or index space 
is full. A linear table space or index space can contain a 
maximum of 64 gigabytes of data. 


| Internal DB2 Information ~_—————<—~S “| 


This abend reason code is issued by CSECT(s): DSNISMPI, 
DSNISMXP 


| End of Internal DB2 Information _____ 


System Action: A ‘resource not available’ code is returned to 
the end user and the requested action is not performed. The 
SVC dump and the SYS1.LOGREC recording are not requested. 


User Response: Notify the system programmer to reclaim 
some free space in the associated table space index space and 
rerun the job. 


System Programmer Response: The table space or index 
space name is identified in the DSNT500! message. If itis a 
table space, run the DB2 REORG utility to attempt to reclaim 
additional free space. If it is an index space, drop and recreate 
the index with fewer number of SUBPAGEs. Jf free space 
cannot be reclaimed, notify the database administrator to redis- 
tribute the data into different table spaces or index spaces. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


DB2 Codes 4-41 


OOC9009E — 00C900A4 


Problem Determination: For more information, refer to the 
explanation of message DSNT500I in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 36. 


00C9009E 


Explanation: The object depends on new facilities of the 
release from which fall back has occurred and is therefore una- 
vailable for processing. The object will be available after re- 
migration. 


i aa Internal DB2 Information : : = | 


This abend reason code is issued by the following CSECT(s): 
DSNICUBC 


Wee ashe oa! End of Internal DB2 Information eee 


System Action: The operation is not allowed. The data 
manager function that detected this condition returns 
‘RESOURCE NOT AVAILABLE ' to its invoker. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: In order to perform the opera- 
tion on the object, re-migration is required. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The requested operation is not per- 
formed. A SQL return code of -904 is issued. Message 
DSNT500I or message DSNT501! may also be issued. For more 
information, refer to the SQL Return Code section or to the 
description of the DSNT500I and DSNT5011 messages in 
‘Service Controller Messages (DSNT...)'. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


00C9009F 


Explanation: A table has been referenced that has a primary 
key but no index exists to enforce its uniqueness. The refer- 
ence is usually to a parent table when attempting to verify the 
referential constraint of an insert or update operation to a 
dependent table. 


| ; = Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNIALLC DSNICUBC SNIKESR 
DSNIRELI 


te ee End of Internal DB2 Information a 


System Action: The use of the table is not allowed. 


User Response: Create a primary index on the referenced 
table. 


Problem Determination: The requested operation is not per- 
formed. A SQL code of -904 or -923 is issued. For more infor- 
mation, refer to “Section 2. SQL Return Codes” on page 2-1, or 
to the description of the DSNT501!I message in “Service Con- 
troller and Installation Messages (DSNT...)” on page 3-121. 


4-42 DB2 Messages and Codes 


00CS00A0 


Explanation: An attempt was made to allocate a table space, 
map space, or index that is in the Recovery Pending state. 


| Internal DB2 information ~~ ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNIDBAT 


ee End of Internal DB2 Information See 


System Action: The use of the object is not allowed. 


User Response: Determine when the resource is available for 
use and rerun the job. 


Operator Response: Determine whether the Recover utility 
should be run to complete recovering the object. 


Problem Determination: The requested operation is not per- 
formed because the table space/map space/index may be in an 
inconsistent state. A SQL return code of -904 is issued, and/or 
message DSNTS500I is issued. For more information, refer to 
“Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT501!I message in “Service Controller and 
Installation Messages (DSNT...)” on page 3-121. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00C900A3 


Explanation: An attempt was made to allocate a table space 
which is in the CHECK PENDING state. 


[ ~~ {nternal DB2 Information Taare a | 


This abend reason code is issued by the following CSECT(s): 
DSNIPSFI, DSNIALLC 


[ate ae: End of Internal DB2 Information | 


System Action: The operation is not allowed. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine whether the table 
space in CHECK PENDING state should be resolved to allow the 
operation. 


Problem Determination: The requested operation is not per- 
formed. A SQL code of -904 or -923 is issued. For more infor- 
mation, refer to “Section 2. SQL Return Codes” on page 2-1, or 
to the description of the DSNT501! message in “Service Con- 
troller and Installation Messages (DSNT...)” on page 3-121. 


For information about resolving the CHECK PENDING state, 
refer to Section 3 (Volume 1) of Administration Guide. 


O0C900A4 


Explanation: An attempt was made to allocate a segment for a 
table in a segmented table space, but there are no free seg- 
ments. A segmented table space can contain a maximum of 64 
gigabytes of data. A segment will be allocated under one of the 
following conditions: 


e¢ When a table is ready to be created in a segmented table 
space via the 'CREATE TABLE' DDL statement. 


e When a record is inserted/loaded into a segmented table 
and free space is not available from existing segments. 


[ as Internal DB2 Information | 


This abend reason code is issued by CSECT(s): DSNISEGF, 
DSNISGNS 


es End of Internal DB2 Information ee eee 


System Action: A ‘resource not available' code is returned to 
the end user and the requested action is not performed. 


User Response: Notify the system programmer to reclaim 
some free space in the associated segmented table space and 
rerun the job. 


System Programmer Response: An SQL return code -904 is 
issued, and/or message DSNT5011 is issued. The segmented 
table space name is identified in SQLCA and/or in the DSNT5011 
message. If the requested function is the DDL ‘CREATE 
TABLE' statement, create the table in a different segmented 
table space. Otherwise, run the DB2 REORG utility to attempt to 
reclaim additional free space. If no free space can be 
reclaimed, then notify the database administrator to redistribute 
the data into different table spaces. 


Problem Determination: For more information, refer to the 
explanation of message DSNT501! in the Service Controller 
Messages section of this manual. 


Collect the following diagnostic items listed in Appendix .B, 
“Problem Determination” on page X-5: 1, 36. 


00C900A5 
Qe 
Explanation: One of the following has occurred: 


* Atemporary file is full. 

¢ The maximum number of extensions for VSAM data set tem- 
porary files has been exceeded. 

¢ A volume has no space available in which to extend. 


oes eee Interna! DB2 Information a = 
This reason code is issued by following CSECT(s): DSNIXWKF 


es End of Internal DB2 Information a | 


System Action: The reason code appears in a DSNT5011 
message. The requested operation is not performed. 


User Response: Ifthe reason code appears in a DSNTS501I 
message, issue -DISPLAY THREAD to determine the total 
number of concurrent users of temporary files. If there were a 
large number of users, resubmit the job when the number of 
users is lower. IDCAMS LISTCAT may be used to determine the 
VSAM data set space allocations. 


Do one of the following: 


¢ if there was no space available on a volume, clear space 
from the volume, add more volumes to the STOGROUP, or 
redefine the VSAM data set to concatenate more volumes. 

e ifthe maximum number of extensions has been exceeded 
for a VSAM data set, use ALTER or DELETE and redefine 
the temporary data sets to make them larger. 

¢ if all the temporary files are full, create or define more tem- 
porary files. 


issue the -START DATABASE command to start the temporary 
file. 


OOCS900A5 — 00C900A7 


Problem Determination: The requested operation is not per- 
formed. SQL return code -904 or message DSNT5011 is issued. 
For more information, refer to the SQL return code -904 in 
“Section 2. SQL Return Codes” on page 2-1, or to the 
description of the DSNT5011 message in “Section 3. DB2 
Messages” on page 3-1. 


Collect the definitions of the temporary files involved in the 
error. Also collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 10, 31. 


O00C900A6 


Explanation: Access to the catalog has been requested but 
denied because the catalog has not been migrated to the 
current release level. The object in the catalog will be avail- 
able after the catalog has been migrated. 


| : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNICUBC 


a ae End of internal DB2 Information ee 


System Action: The operation is not allowed. The data 
manager function that detected this condition returns 
"RESOURCE NOT AVAILABLE ' to its invoker. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: In order to perform the opera- 
tion on the object, migration of the catalog to the current 
release is required. This can be accomplished by running 
DSNTIJTC (refer to Section 2 (Volume 1) of Administration 
Guide for information about this job). 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 and message DSNT501! are 
issued. For more information refer to the SQL Return Code 
section or to the description of the DSNT501! message in 
“Service Controller and Installation Messages (DSNT...)” on 
page 3-121. 


00CS00A7 


Explanation: At allocation of a bound plan, a lock inconsist- 
ency is detected. A DB2 internal bind error is probably respon- 
sible for this condition. The plan cannot be allocated. 


= ~ ” ~~ Internal DB2 Information = = | 


This reason code is issued by the following CSECT(s): 
DSNIALLC 


= End of internal DB2 Information dd 


System Action: The plan is not allocated. A DSNT501! 
message is issued and a SQL -923 is returned to the applica- 
tion. 


System Programmer Response: Re-bind the plan. 


Problem Determination: If the problem persists after the plan 
is rebound, collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 5, 31, 
32. 


DB2 Codes 4-43 


00090101 — 00C90103 


00C90101 


Explanation: The data manager detected an internal error 
within DB2. This error may indicate inconsistent data or an 
error in interna! DB2 control structures or code. 


| Internal DB2 Information = : 


This abend reason code is issued by the CSECT DSNnnnnn. 
'‘nnnnn' is the CSECT name identifier given in VRARRKS of the 
VRA in the SDWA (see the Problem Determination section of 
this message). 'DSNnnnnn’' is the full CSECT name given in 
the dump title. 


Rema setes End of Internal DB2 Information re 


Possible causes of this error include: 


¢ Improper migration or fall back procedures, 

¢ DB2 directory and DB2 Catalog restored to different points 
in time, 

* Table space restored improperly, 

¢ An internal DB2 failure 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about analyzing '00C90101' abends 
and index recovery. 


Problem Determination: If this abend occurred while proc- 
essing data in one or more pages, message DSNI014I is issued 
to identify each page involved. In general, the data in these 
pages is fine. However, if problems are reported that repeat- 
edly involve the same pages or if the same pages are reported 
by other abends, you may want to analyze the set of pages 
specified. 


Run the CHECK utility to determine the extent of index incon- 
_Sistency if: 


e The page type indicated in message DSNI014I is index 

* The page type indicated in message DSNIO14I is data 

e There is an index defined on a table in the indicated page 
set. 


The LOC keyword in the dump title gives the 
Load-module.CSECT:qualifier of the location where the abend 
occurred. ‘Qualifier’ is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKS. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 39, 40. 


if the abend reason code was issued by a CSECT with a name 
of the form DSNGxxxx, where 'xxxx' is insignificant, make a 
copy, with DSNICOPY, of DSNDB01.DB01, DSNDB01.SCT02, and 
DSNDB01.DSNSCTO02 on tape. This may be a large copy. 


4-44 DB2 Messages and Codes 


00090102 


Explanation: An inconsistent page was detected. This has 
been caused by a DB2 internal error. 


ios “= Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNIBROK 


ae End of Internal DB2 Information | 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


System Programmer Response: Refer to Section 4 of Diag- 
nosis Guide and Reference for information about how to resolve 
the inconsistent page and for information about how to describe 
and report the problem. 


Problem Determination: SYS1.LOGREC contains information in 
the variable recording area (VRA) of the system diagnostic 
work area (SDWA). Significant fields for this code are: 
VRARRKS, VRARRK6, VRARRK7, VRARRK8, and VRARRKQY. 
Refer to Section 5 of Diagnosis Guide and Reference for infor- 
mation about VRA data and finding the SDWA. 


In addition, the following generai purpose registers (GPRs) 
contain the indicated diagnostic information: 


GPR Content 


2 Address of the page set block (PB) 
3 Address of the log record, if any 

8 Address of the buffer block (BB) 

9 Address of the page buffer 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 6, 12, 31. 


00090103 


Explanation: Bad data was returned from either the edit or the 
validation exit. 


— "Internal DB2 Information - we zi 


This abend reason code is issued by the following CSECT(s): 
DSNIREDR, DSNIENSR 


ase ek End of Internal DB2 Information oe ee 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis, service aids, and finding 
the SDWA. 


Problem Determination: SYS1.LOGREC contains the same 
diagnostic information in the variable recording area (VRA) as 
in abend reason code '00C90101'. Refer to the table accompa- 
nying that abend reason code for details. 


The '00C90103' abend reason code was issued because one of 
the checks described in the following list failed: 


© Save first four and last four bytes of the input record. On 
return from exit, see if either group has been modified. If 
so, abend. 

¢ Check length of edited data. If greater than maximum 
allowed for this row, or less than one, abend. 


e Store a special character in the first byte past the end of the 
output area (place for edit procedure to put edited or (ori- 
ginal unedited) row), to make sure the exit doesn’t overrun 
this area. On return, check if it is still the same special 
character. If not, abend. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this code are: VRARRK5, VRARRK6, VRARRK7, 
VRARRK8, and VRARRK&Q. 


00090105 


Explanation: An inconsistent page was detected. This has 
been caused by a DB2 internal error. 


| a ; ~ Internal DB2 information = —<C~;C;7;O ‘| 


This abend reason code is issued by the following CSECT(s): 
DSNIBROK 


Goes End of Internal DB2 Information a ee sl 


System Action: A record is written to SYS1.LOGREC, an SVC 
dump is requested, and the page will be scheduled for auto- 
matic recovery. !f automatic recovery is successful, message 
DSNB2151 is issued. If automatic recovery fails, message 
DSNI012I is issued, and an abend '04E' with reason code 
00090102 will occur. 


Note: Ifthe resource required for automatic recovery is in use, 
automatic recovery will be delayed until the resource is avail- 
able. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis, service aids, and finding 
the SDWA. 


Problem Determination: SYS1.LOGREC contains information in 
the variable recording area (VRA) of the system diagnostic 
work area (SDWA). Significant fields for this code are: 
VRARRKS5, VRARRK6, VRARRK7, VRARRK8, and VRARRKQ. 
Exceptions to the table definitions of the VRA fields are: 


¢ VRARRKS is the name of the module that called the check 
page routine that detected the error in the page. 
¢ VRARRKG identifies the error in the page. 


The following general purpose registers (GPRs) contain the 
indicated diagnostic information: 


GPR Content 


2 Address of the page set block (PB) 
3 Address of the log record, if any 

8 Address of the buffer block (BB) 

9 Address of the page buffer 


00090106 


Explanation: The entry is not found for a table space that is 
being set for deferred restart. An error in DB2 logic is probably 
responsible for this condition. 


00C90105 — 00C90109 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNIIMPD 


(ne tee End of Internal DB2 Information _ 


System Action: A record is written to SYS1.LOGREC, an SVC 
dump is requested, and the DB2 restart is terminated. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 31, 32. 


00090107 


Explanation: At commit phase 1, a non-zero write intent count 
was detected. An error in DB2 logic is probably responsible for 
this condition. 


| internal DB2 Information = | 


This abend reason code is issued by the following CSECT(s): 
DSNICMT2 


{| End of Internal DB2 Information _ 


System Action: A record is written to SYS1.LOGREC, an SVC 
dump is requested. The thread is aborted. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 30, 31, 32. 


00090108 


Explanation: At commit phase 2, a non-zero read intent count 
or write intent count was detected. An error in DB2 logic is 
probably responsible for this condition. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNICMT2 


{oo End of Internal DB2 information ne 


System Action: A record is written to SYS1.LOGREC, anda 
SVC dump is requested. The thread is committed and the appli- 
cation is allowed to continue without notification of the error. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 30, 31, 32. 


DB2 Codes 4-45 


00090109 — 00090202 


00090109 


Explanation: At deallocate, a non-zero read intent count or 
write intent count was detected. An error in DB2 logic is prob- 
ably responsible for this condition. 


| Internal DB2 Information : =~ 


This abend reason code is issued by the following CSECT(s): 
DSNIDALC 


————s End of Internal DB2 Information Ee call 


System Action: A record is written to SYS1.L.OGREC, anda 
SVC dump is requested. The thread is deallocated normally. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 30, 31, 32. 


00090110 


Explanation: The data manager detected an inconsistent data 
condition. This may be caused by an inconsistency in either the 
DB2 Catalog or the DB2 Directory. In this case, the OBD for the 
requested OBID cannot be located in the database descriptor 
(DBD). The DBD in storage may be inconsistent. Specifically, 
the OBDDMAP(OBID) array element should contain an offset 
into the DBD where the OBD should be located. However, in 
this case the OBD expected was not at the indicated offset. 


To prevent further damage and possible loss of data, the incon- 
sistency must be corrected before any further DDL or DML is 
attempted in this database. 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which databases 
were being used when the error occurred. Prevent further DDL 
and DML in the databases. Refer to Section 4 of Diagnosis 
Guide and Reference for diagnosing inconsistent DBD problems 
and for failure analysis procedures. 


Probiem Determination: The DBD in use at the time of the 
ABEND is inconsistent in storage and may be inconsistent on 
DASD. Since the nature and extent of the damage done to the 
DBD is not immediately known, an analysis of the entire DBD 
must be done. 


The inconsistency may be due to: 


¢ Incomplete recovery of DB2 Catalog and/or DB2 Directory. 

¢ Invalid restore of DB2 Catalog and/or DB2 Directory to a 
prior point in time. 

* Aconditional restart which bypassed recovery of either the 
DSNDB01.DBD01 page set or the DSNDB06.SYSDBASE page 
set. 

¢ A DB2 internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 68, 69, 70, 71. 


4-46 DB2 Messages and Codes 


00090111 


Explanation: The data manager detected an inconsistent data 
condition. In this case, the OBD for the requested OBID does 
not exist. This may be caused by an inconsistency in either the 
DB2 Catalog or the DB2 Directory. Specifically, the 
OBDDMAP(OBID) entry is zero rather than an offset to an OBD 
within the DBD. 


To prevent further damage and possible loss of data, the incon- 
sistency must be corrected before any further DDL or DML is 
attempted in this database. 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which databases 
were being used when the error occurred. Prevent further DDL 
and DML in the databases. Refer to Section 4 of Diagnosis 
Guide and Reference for diagnosing inconsistent DBD problems 
and for for failure analysis procedures. 


Problem Determination: Since the DB2 Directory does not 
agree with the DB2 Catalog, either of these may be incon- 
sistent. Since the nature and extent of the inconsistency 
between the DB2 Catalog the DBD is not immediately known, an 
analysis of the entire DBD must be done. 


The inconsistency may be due to: 


¢ Incomplete recovery of DB2 Catalog and/or DB2 Directory. 

¢ Invalid restore of DB2 Catalog and/or DB2 Directory to a 
prior point in time. 

e Aconditional restart which bypassed recovery of 
DSNDB01.DBD01 or DSNDBO6.SYSDBASE page sets. 

* A DB2 internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Probiem Determination” on page X-5: 1, 5, 68, 69, 70, 71. 


00C90202 


Explanation: The data manager detected an inconsistent data 
condition. In this case, one of the pointers in a tink does not 
point to a valid child or parent row (that is, the link is 'broken'). 
The pointer, the target row, or the page that contains the 
pointer or target row is in error. 


i Te aa Internal DB2 Information ~~ — 73, 


This abend reason code is issued by the CSECT DSNnnnnn. 
'‘nnnnn' is the CSECT name identifier given in VRARRKS of the 
VRA in the SDWA (see the Problem Determination section of 
this message). 'DSNnnnnn’ is the full CSECT name given in 
the dump title. 


—— End of Internal DB2 Information ees) 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save the output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, 
service aids, and finding the SDWA and for information about 
links and resolving inconsistent data problems. 


Problem Determination: Message DSNI013I is issued to identify 
the data pages. lt identifies the database name and table space 
name. This message is issued for all pages in use at the time 
of the abend. Within this group of pages, at least one page is 
involved in the inconsistency. The other pages were present at 
the time of the abend. 


The LOC keyword in the dump title gives the 
Load-module.CSECT:qualifier of the location where the abend 
occurred. 'Qualifier' is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQY. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 41. 


00C90203 


Explanation: The data manager detected an inconsistent data 
condition. In this case, one of the pointers in a hash chain does 
not point to a valid row or anchor (that is, the hash chain is 
'broken'). The pointer, the target row/anchor, or the page that 
contains the pointer or target row/anchor is in error. 


[ internal DB2 Information | 


This abend reason code is issued by the CSECT DSNnnnnn. 
‘nnnnn' is the CSECT name identifier given in the dump header 
and appearing in VRARRK5 of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn'‘ 
is the full CSECT name given in the dump title. 


Hee ete End of Internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about hashes and resolving incon- 
sistent data problems. 


Problem Determination: Message DSNI013i is issued to identify 
the data pages. It identifies the database name and the table 
space name. This message is issued for all pages in use at the 
time of the abend. Within this group of pages, at least one page 
is involved in the inconsistency. The other pages were present 
at the time of the abend. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQY. 


The LOC keyword in the dump title gives the 
Load-module.CSECT: qualifier of the location where the abend 
occurred. 'Qualifier' is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 41. 


00090203 — 00C90206 


00090205 


Explanation: The data manager detected an inconsistent data 
condition. In this case, a row obtained from an index entry 
does not point to a valid row in a data page. The error is prob- 
ably caused by an extra index entry, but it could also result 
from a table update not being redone when it should have been. 


| internal DB2 Information | 


This abend reason code is issued by the CSECT DSNnnnnn. 
‘nnnnn' is the CSECT name identifier given in the dump header 
and appearing in VRARRKS of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn' 
is the full CSECT name given in the dump title. 


—— End of Internal DB2 Information _ 


System Action: A record is written to SYS1.L.OGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about resolving inconsistent data 
and index problems. 


Problem Determination: Message DSNI013!I is issued to identify 
the index page. It identifies the database name, table space 
name, and index space name. This message is issued for all 
pages in use at the time of the abend. Within this group of 
pages, at least one page is involved in the inconsistency. The 
other pages were present at the time of the abend. 


Run the CHECK utility to determine the extent of index incon- 
sistency if: 


°® The page type indicated in message DSNI014! is index 

¢ The page type indicated in message DSNI014I is data 

* There is an index defined on a table in the indicated page 
set. 


The LOC keyword in the dump title gives the 
Load-module.CSECT:qualifier of the location where the abend 
occurred. ‘Qualifier’ is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRK9Q. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 40, 41. 


00C90206 


Explanation: The data manager detected an inconsistent data 
condition. In this case, a row that should be pointed to by an 
index does not have an index entry. The error is probably 
caused by a missing index entry, but it could also be caused by 
a table update that was not backed out when it should have 
been. 


DB2 Codes 4-47 


00090207 — 00C90210 


| Internal DB2 Information : | 


This abend reason code is issued by the CSECT DSNnnnnn. 
‘nnnnn‘ is the CSECT name identifier given in the dump header 
and appearing in VRARRKS of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn' 
is the full CSECT name given in the dump title. 


rat End of Internal DB2 Information _ 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about resolving inconsistent data 
and index problems. 


Problem Determination: Message DSNI0131 is issued to identify 
the data pages. It identifies the database name, table space 
name, and index space name. This message is issued for all 
pages in use at the time of the abend. Within this group of 
pages, at least one page is involved in the inconsistency. The 
other pages were present at the time of the abend. 


Run the CHECK utility to determine the extent of index incon- 
sistency if: 


¢ The page type indicated in message DSNIO14I is index 

¢ The page type indicated in message DSNIO14I is data 

¢ There is an index defined on a table in the indicated page 
~ set. 


The LOC keyword in the dump title gives the 
Load-module.CSECT-:qualifier of the location where the abend 
occurred. 'Qualifier' is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRKG, 
VRARRK7, VRARRK8, and VRARRK&. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 40, 41. 


00C90207 


Explanation: The data manager detected an inconsistent data 
condition. In this case, a pointer record does not point to a 
valid overflow record. The pointer record, the overflow record, 
or the page that contains the pointer or overflow record is in 
error. 


[ ~~ Internal DB2 information ~~ | 


This abend reason code is issued by the CSECT DSNnnnnn. 
‘nnnnn' is the CSECT name identifier given in the dump header 
and appearing in VRARRKS of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn' 
is the full CSECT name given in the dump title. 


reer Peeoer End of Internal DB2 Information ree 


4-48 DB2 Messages and Codes 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about overflow records and 
resolving inconsistent data problems. 


Problem Determination: Message DSNI013I is issued to identify 
the data pages. It also identifies the database name and the 
table space name. This message is issued for all pages in use 
at the time of the abend. Within this group of pages, at least 
one page is involved in the inconsistency. The other pages 
were present at the time of the abend. 


The LOC keyword in the dump title gives the 
Load-module.CSECT: qualifier of the location where the abend 
occurred. ‘Qualifier’ is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQ. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 41. 


0090210 


Explanation: The data manager detected an inconsistent data 
condition. In this case, the subpage directory of an index leaf 
page indicates that a given search key doesn’t belong to any of 
the subpages. Either this leaf page is the index tree or the non- 
leaf portion of the index tree lead to this leaf page as the one 
that should contain the given key. 


| Internal DB2 Information | 


This abend reason code is issued by the CSECT DSNnnnnn. 
‘nnnnn' is the CSECT name identifier given in the dump header 
and appearing in VRARRKS of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn' 
is the full CSECT name given in the dump title. 


[ite eae tet End of Internal DB2 Information ee el 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about links and resolving incon- 
sistent data problems. 


Problem Determination: Message DSNI013I is issued to identify 
the index page. It also identifies the database name and index 
space name. This message is issued for all pages in use at the 
time of the abend. Within this group of pages, at least one page 
is involved in the inconsistency. The other pages were present 
at the time of the abend. 


The LOC keyword in the dump title gives the Load 
module.CSECT: qualifier of the location where the abend 


occurred. ‘Qualifier’ is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQ. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 42. 


00090211 


Explanation: The data manager detected an inconsistent data 
condition. In this case, a row is missing a column that is not 
nullable and does not allow default values. 


[~ — Internat DB2 Information | 


This abend reason code is issued by the CSECT DSNnnnnn. 
‘nnnnn' is the CSECT name identifier given in the dump header 
and appearing in VRARRKS of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn' 
is the full CSECT name given in the dump title. 


[Dnbeey fate ae End of Internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about links and resolving incon- 
sistent data problems. 


Problem Determination: Message DSNIO013I is issued to identify 
the data page. It also identifies the database name and table 
space name. This message is issued for all pages in use at the 
time of the abend. Within this group of pages, at least one page 
is involved in the inconsistency. The other pages were present 
at the time of the abend. 


The LOC keyword in the dump title gives the Load 
module.CSECT: qualifier of the location where the abend 
occurred. 'Qualifier' is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQY. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 41, 61. 


00C90212 


Explanation: The data manager detected an inconsistent data 
condition. In this case, there is an empty index leaf page other 
than the root. (DB2 removes empty pages from the index tree 
when they become empty). 


00090211 — 00C90213 


| Internal DB2 Information ~~ pe ea 


This abend reason code is issued by the CSECT DSNnnnnn. 
‘nnnnn' is the CSECT name identifier given in the dump header 
and appearing in VRARRKS5 of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn' 
is the full CSECT name given in the dump title. 


a End of Internal DB2 Information hres 2 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and finding the 
SDWA, and for information about links, resolving inconsistent 
data problems, and index recovery. 


Problem Determination: Message DSNI0131 is issued to identify 
the index leaf page. It also identifies the database name and 
index space name. This message is issued for all pages in use 
at the time of the abend. Within this group of pages, at least 
one page is involved in the inconsistency. The other pages 
were present at the time of the abend. 


Run the CHECK utility to determine the extent of index incon- 
sistency if: 


¢ The page type indicated in message DSNIO141 is index 

¢ The page type indicated in message DSNI014I is data 

¢ There is an index defined on a table in the indicated page 
set. 


The LOC keyword in the dump title gives the Load 
module.CSECT:qualifier of the location where the abend 
occurred. 'Qualifier' is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQ. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 40, 42. 


00C90213 


Explanation: The data manager detected an inconsistent data 
condition. In this case, a row has an unexpected OBID stored in 
its prefix. A possible cause is that the table space was restored 
(via DSN1COPY or similar tool) improperly. For example, the 
wrong data set was copied for the given table space. 


[ a ~~ Internal DB2 Information ls 


This abend reason code is issued by the CSECT DSNnnonn. 
‘nnnnn' is the CSECT name identifier given in the dump header 
and appearing in VRARRKS of the VRA in the SDWA (see the 
Problem Determination section of this message). 'DSNnnnnn' 
is the full CSECT name given in the dump title. 


——a End of Internal DB2 Information eres | 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


DB2 Codes 4-49 


00C90214 — 00C90216 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis, service aids, and finding 
the SDWA, and for information about links and resolving incon- 
sistent data problems. 


Problem Determination: Message DSNIO13I is issued to identify 
the data page. It also identifies the database name and table 
space name. This message is issued for all pages in use at the 
time of the abend. Within this group of pages, at least one page 
is involved in the inconsistency. The other pages were present 
at the time of the abend. 


The LOC keyword in the dump title gives the Load 
module.CSECT:qualifier of the location where the abend 
occurred. 'Qualifier' is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQ. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 41, 61. 


00090214 


Explanation: The data manager detected a condition of incon- 
sistent data. The description of the index in the index OBD 
does not match the attributes of an index page. The problems 
consists of one of the following conditions: 


IPPNUNI does not equal OBDKNUNI, 

IPPTLTH does not equal OBDKLEN, 

IPPOLTH does not equal OBDLENO, or 

If the page is a leaf page, the segmentation flag or number 
of subpages conflict (IPPNLPG does not equal OBDINLPG 
or IPPSEGM conflicts with OBDINLPG). 


The index space may have been improperly restored by using 
DSN1COPY or the wrong data set may have been copied for the 
given index. 


| Internal DB2 Information na = | 


This abend reason code is issued by the following CSECT(s): 
DSNnnnnn ('nnnnn' is the CSECT name identifier given in 
VRARRKS of the VRA in the SDWA) 'DSNnnnnn‘' is the full 
CSECT name given in the dump title. 


ee ees End of Internal DB2 Information pines oes 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis, service aids, and the 
SDWA, and for information about indexes and data inconsist- 
ency problems. 


Problem Determination: Message DSNI013I will be issued for 
each index page. It identifies the database, and the index 
name. This message is issued for all pages in use at the time 
of the abend. Within this group of pages, at least one page is 
involved in the inconsistency. The other pages were present at 
the time of the abend. 


The LOC keyword in the dump title gives the 
Load-module.CSECT:qualifier of the location where the abend 


4-50 DB2 Messages and Codes 


occurred. ‘Qualifier’ is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRKS8, and VRARRKQ. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 41, 43, 
61. 


00090215 


Explanation: The data manager detected a condition of incon- 
sistent data. The index manager subcomponent has been 
passed a key with a key length not equal to the key length in 
pages of the index. The index space may have been improperly 
restored by using DSN1COPY or the wrong data set may have 
been copied for the given index. 


” . Internal DB2 Information ~~ = | 


This abend reason code is issued by the following CSECT(s): 
DSNnnnnn ('nnnnn' is the CSECT name identifier given in 
VRARRKS of the VRA in the SDWA). 'DSNnnnnn' is the full 
CSECT name given in the dump title. 


ae End of Internal DB2 Information fae ett 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures, for 
information about dump analysis, service aids, and the SDWA, 
and for information about indexes and data inconsistency prob- 
lems. 


A Recover Index will! restore the Index to a correct condition. 


Problem Determination: Message DSNI013! will be issued for 
each index page. It identifies the database, the index name. 
This message is issued for all pages in use at the time of the 
abend. Within this group of pages, at least one page is involved 
in the inconsistency. The other pages were present at the time 
of the abend. 


The LOC keyword in the dump title gives the 
Load-module.CSECT:qualifier of the location where the abend 
occurred. 'Qualifier' is a unique, 4-digit hexadecimal number 
that identifies the place within the source module (CSECT) 
where the abend was issued. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKY. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 30, 31, 32, 41, 43, 
61, 62, 63. 


00C90216 


Explanation: The data manager has detected an inconsistent 
data condition. In this case, a condition has occurred where the 
length of a record in a table space is longer than the maximum 
defined record length as defined in the DB2 directory. 


| Internal DB2 Information | 
This abend reason code is issued by CSECT(s): DSNIRNXT 


Ls End of Internal DB2 Information _____—_| 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Refer to Section 4 of Diag- 
nosis Guide and Reference and Section 3 (Volume 1) of Admin- 
istration Guide for more information. 


Problem Determination: Message DSNI0131 is issued to identify 
the data page that contains the record that is longer than 
allowed by its corresponding record definition. This could 
occur if the DB2 directory was recovered to a previous point, 
allowing new object creations (with a shorter record length) to 
be created having record identifiers identical to objects previ- 
ously created in the table space. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 2, 31, 32, 41, 61, 64, 
65. 


00C90218 


Explanation: The data manager detected an inconsistent data 
condition in a segmented table space. In this case, an unallo- 
cated segment was found on a segment chain. 


| Internal DB2 Information : 


This abend reason code is issued by the CSECT DSNnnnnn. 
The CSECT name identifier given in the dump header and 
appearing in VRARRKS of the VRA in the SDWA is ‘nnnnn' (see 
the Problem Determination section of this message). The full 
CSECT name given in the dump title is 'DSNnnnnn'. 


_——— End of Internal DB2 Information i ee te 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis, service aids, finding the 
SDWA, and resolving inconsistent data problems. 


Problem Determination: Message DSNI013I is issued to identify 
the space map page that contains the bad segment entry. The 
database name and table space name will also be identified. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQY. Refer to the table in 
Section 5 of Diagnosis Guide and Reference for the contents of 
these VRA fields. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 31, 36. 


00C90218 — 00C9021A 


00C90219 


Explanation: The data manager detected an inconsistent data 
condition in a segmented table space. tn this case, an allo- 
cated segment was found on a wrong segment chain (that is, a 
segment chain contains a segment that belongs to a different 
table). 


os Internal DB2 Information a 


This abend reason code is issued by the CSECT DSNnnnnn. 
The CSECT name identifier given in the dump header and 
appearing in VRARRKS of the VRA in the SDWA is 'nnnnn' (see 
the Problem Determination section of this message). The full 
CSECT name given in the dump title is ‘DSNnnnnn'. 


eres End of Internal DB2 Information bee pci ee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis, service aids, finding the 
SDWA, and resolving inconsistent data problems. 


Problem Determination: Message DSNI013i is issued to identify 
the space map page that contains the bad segment entry. The 
database name and table space name will also be identified. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRK9Y. Refer to the table in 
Section 5 of Diagnosis Guide and Reference for the contents of 
these VRA fields. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 31, 36. 


00CS021A 


Explanation: The data manager detected an inconsistent data 
condition in a segmented table space. In this case, a data page 
contains a record which belongs to a table that has not been 
allocated for the page. 


| Internal DB2 Information | 


This abend reason code is issued by the CSECT DSNnnnnn. 
The CSECT name identifier given in the dump header and 
appearing in VRARRKS of the VRA in the SDWA is 'nnnnn' (see 
the Problem Determination section of this message). The full 
CSECT name given in the dump title is 'DSNnnnnn'. 


[ee es End of Internal DB2 Information ————— 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


DB2 Codes 4-51 


00C9021B — 00C9021D 


System Programmer Response: Refer to Section 5 of Diag- | 
nosis Guide and Reference for failure analysis procedures and 
information about dump analysis, service aids, finding the 
SDWA, and resolving inconsistent data problems. 


Problem Determination: Message DSNI0131 is issued to identify 
the data page that contains the bad data record. The database 
name and table space name will also be identified. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQY. Refer to the table in 
Section 5 of Diagnosis Guide and Reference for the contents of 
these VRA fields. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 31, 36. 


00C9021B 


Explanation: The data manager detected an inconsistent data 
condition in a segmented table space. In this case, the space 
map page indicates a non-empty data page exists. However, 
the data page is either not formatted by the data manager or it 
is beyond the highest VSAM formatted area. 


| Internal DB2 Information | 


This abend reason code is issued by the CSECT DSNnnnnn. 
The CSECT name identifier given in the dump header and 
appearing in VRARRKS of the VRA in the SDWA is 'nnnnn' (see 
the Problem Determination section of this message). The full 
CSECT name given in the dump title is 'DSNnnnnn'. 


Ries tree as End of internal DB2 Information pe tees | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis, service aids, finding the 
SDWA, and resolving inconsistent data problems. 


Problem Determination: Message DSNI013! is issued to identify 
the inconsistent data page and its covering space map page. 
The database name and table space name will also be identi- 
fied. 


SYS1.LOGREC contains information in the variable recording 
area (VRA) of the system diagnostic work area (SDWA). Signif- 
icant fields for this abend code are: VRARRK5, VRARRK6, 
VRARRK7, VRARRK8, and VRARRKQ. Refer to the table in 
Section 5 of Diagnosis Guide and Reference for the contents of 
these VRA fields. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 31, 36. 


4-52 DB2 Messages and Codes 


00C9021C 


Explanation: While running a utility, the data manager 
detected an inconsistent data condition. A row was encount- 
ered that is not represented by a record OBD in the database 
descriptor (DBD). This abend may indicate an internal DB2 
error, but most likely occurs due to a user error. Possible user 
errors may include: 


¢ Data from a DB2 subsystem was copied to another DB2 sub- 
system incorrectly. This is the most common error. 


¢ DSNDBO1.DBD01 was regressed to a time prior to a table 
being created. 


Refer to Section 4 of Diagnosis Guide and Reference for more 
information about the 00C9021C reason code. 


— Internal DB2 Information | 


This abend reason code is issued by the CSECT(s): DSNIRFNX, 
DSNISNPG 


———— End of Internal DB2 Information Sa eae = i 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. The dump is required in the event that 
the problem is determined to be a DB2 internal error. 


User Response: Notify the system programmer. 


System Programmer Response: Determine if improper proce- 
dures were used to restore the table space or DBD that would 
lead to the inconsistency. If a DB2 internal error is indicated, 
refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis, 
service aids, finding the SDWA, and resolving inconsistent data 
problems. 


Problem Determination: Message DSNI013!I will be issued. 


If a DB2 internal error is indicated, collect the following diag- 
nostic items: 


¢ DSN1COPY of the user table space. 
¢ DSN1COPY of DSNDBO1.DBD01. 


Also collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 30, 31, 32, 36. 


00C9021D 


Explanation: During a LOAD/REORG utility or termination of a 
utility, the data manager detected an inconsistent data condi- 
tion. A space map page was missing from the table space. 
This abend may indicate an internal DB2 error (caused by the 
utilities subcomponent passing a bad start position to the data 
manager), but most likely occurs due to a user error. Possible 
causes are that the table space data set has been deleted and 
redefined without DB2’s knowledge, or that the table space was 
incorrectly restored from an improper DSN1COPY of the table 
space. 


fe ~~ Internal DB2 Information ” | 


This abend reason code is issued by the following CSECT(s): 
DSNIDLOD 


ee End of Internal DB2 Information _ 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The dump is required in the event that 
the problem is determined to be a DB2 internal error. 


User Response: Notify the system programmer. 


System Programmer Response: Determine if the data set was 
improperly restored or deleted and redefined by the user. Ifa 
DB2 internal error is indicated, refer to Section 5 of Diagnosis 

Guide and Reference for failure analysis procedures, for infor- 
mation about dump analysis, service aids, and the SDWA, and 

for information about data inconsistency problems. 


Probiem Determination: Message DSNI013! wil! be issued. If 
the message information describes page 'xx0001'X of the tabie 
space, this indicates that the data set was deleted and rede- 
fined without DB2’s knowledge. 


If a DB2 internal error is indicated, collect the following diag- 
nostic items listed in Appendix B, “Problem Determination” on 
page X-5: 1, 2, 5, 10, 11, 30, 31, 32, 36, 42. 


00C9021E 


Explanation: The data manager detected an inconsistent data 
condition in a segmented table space. An invalid page was 
requested. The page number is outside the highest formatted 
RBA for the page set. Either the segment chain is broken, or 
the table space has been truncated. A truncated table space 
could be caused by a user error. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNISGSC, DSNISNPG 


es End of internal DB2 Information eat Sie wl 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


00C9021E — 00C9021F 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures 
information about dump analysis, service aids, and finding the 
SDWA. Refer to Section 3 of Diagnosis Guide and Reference for 
information about resolving inconsistent data problems. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
3, 5, 31, 36. 


00C9021F 


Explanation: The data manager detected an inconsistent data 
condition in a segmented table space. A duplicate first 
segment block for a table is found during the rebuilding of the 
first segment block in a segmented table space. The segment 
chain may be broken. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNISEGR 


[| End of interna! DB2 Information 2. | 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Collect the console output from the 
system on which the job was run for the period of time spanning 
the failure. Save this output for use in problem determination. 


System Programmer Response: Refer to Section 3 of Diag- 
nosis Guide and Reference for information about space map 
pages. Refer to Section 4 of Diagnosis Guide and Reference for 
information about resolving inconsistent data problems. Refer 
to Section 5 of Diagnosis Guide and Reference for failure anal- 
ysis procedures and for information about dump analysis, 
service aids, and finding the SDWA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
3, 5, 31, 36, 66, 67. 
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00D10010 — 00D10012 





Recovery Log Manager Reason Codes (X'D1') 


The recovery log manager (RLM) subcomponent of 
DB2 provides the following 'RLM standard' diag- 
nostic information in the SYS1.LOGREC variable 
recording area (VRA) of the SDWA for many of the 
reason codes: 


MODID Name of module issuing the abend 

LEVEL Change level 

COMPONENT Subcomponent ID of recovery log 
manager 

REGISTERS General purpose registers (GPRs) 


0 through 15 at time of abend 


For information about finding the SDWA, refer to 
Section 5 of Diagnosis Guide and Reference. 


Stand-Alone Log Services 


00010010 


Explanation: The DB2 Stand-Alone Log Services OPEN proc- 
essing macro (DSNJSLR) issues this reason code. The RANGE 
parameter on the OPEN request specifies the address of a 
12-byte area containing the log relative byte address (RBA) 
range to be processed by subsequent GET requests. However, 
the RBA specified in the second six bytes of the RANGE param- 
eter (which indicates the end of the log RBA ) is less than or 
equal to the RBA specified in the first six bytes of the RANGE 
parameter (which indicates the start of the log RBA). 


| internal DB2 Information a | 


This reason code is issued by the following CSECT(s): 
DSNJRSO1 


Hees iets eee End of Interna! DB2 Information hee | 


System Action: In response to the DSNJSLR FUNC = OPEN cai, 
DB2 places a return code of 8 in register 15 and a reason code 
of 00D10010 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRSO1), and no information is 
written to SYS1.LOGREC data set. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Correct the RANGE RBA 
parameter input, and resubmit the request. 


00D10011 


Explanation: The DB2 Stand-Alone Log Services OPEN and 
GET processing macro (DSNJSLR) issued this reason code. 
During the initial processing of a FUNC = OPEN or FUNC = GET 
request, storage is obtained to contain the control blocks and 
other information required to process this request. An MVS 
GETMAIN failed when attempting to obtain the required 
storage. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO1, DSNJRSO3, DSNJRSO4 


a End of internal DB2 Information Se 


System Action: In response to the DSNJSLR FUNC=OPEN or 
FUNC = GET call, DB2 places a return code of 8 in register 15 
and a reason code of 00D10011 in register 0. No abend is 
issued by the Stand-Alone Log Services CSECT (DSNJRS01), 
and no information is written to SYS1.LOGREC data set. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: in all likelihood, the REGION 
parameter on the EXEC statement for the user program is too 
small. Increase the REGION size, and resubmit the user 
program. 


00D10012 


Explanation: The DB2 Stand-Alone Log Services OPEN proc- 
essing macro (DSNJSLR) issued this reason code. The Job 
Control Language (JCL) for the user program that uses the 
DSNJSLR macro must specify either the use of the Bootstrap 
data set (BSDS) or, in the absence of the BSDS, the active or 
archive data set(s) which is used in the processing. The 
FUNC = OPEN request failed because neither BSDS nor any log 
data set is allocated for the job. 


—  — internal DB2 Information _ 


This reason code is issued by the following CSECT(s): 
DSNJRS01 


[ie ot ee End of Interna! DB2 Information eee al 


System Action: In response to the DSNJSLR FUNC = OPEN cali, 
DB2 places a return code of 8 in register 15 and a reason code 
of 00010012 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
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00D10013 — 00D10019 


program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Correct the JCL and resubmit 
the user program. 


00D10013 


Explanation: The DB2 Stand-Alone Log Services OPEN proc- 
essing macro (DSNJSLR) issued this reason code. A VSAM 
OPEN error occurred while opening the Bootstrap data set 
(BSDS). 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO04 


pe Se, End of Internal DB2 Information Se: 


System Action: In response to the DSNJSLR FUNC=OPEN call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D10013 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRSO1), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the OPEN request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM OPEN error return code is placed in SLRFRG15. The 
ACB error code (ACBERFLG) is placed in SLRFERCD. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM OPEN error returned in 
SLRFRG15, and the ACB error code returned in SLRFERCD. 
Take appropriate action, and resubmit the FUNC = OPEN 
request. 


00D10014 


Explanation: The DB2 Stand-Alone Log Services OPEN proc- 
essing macro (DSNJSLR) issued this reason code. The Job 
Contro/ Language (JCL) associated with the user-written appli- 
cation determines how access to the DB2 log data is achieved. 
Access can either be through the Bootstrap data set (BSDS), or 
through the explicit inclusion of ddnames in the JCL for the 
active or archive log data set(s) which are to be examined. If 
the BSDS method is used, the user must specify a RANGE 
parameter on the FUNC=OPEN call. This reason code indi- 
cates that the user used the BSDS method, but did not specify 
the range of RBAs to be examined. 
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[- a ~ Internal DB2 Information oe | 


This reason code is issued by the following CSECT(s): 
DSNJRSO1 


[eens End of Internal DB2 Information Bo eel 


System Action: In response to the DSNJSLR FUNC=OPEN call, 
DB2 places a return code of 8 in register 15 and a reason code 
of 00D10014 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Two choices are available: 


1. Continue to use the BSDS method of access. If this choice’ 
is made, then the FUNC = OPEN invocation must specify a 
range of RBAs to be examined by use of the RANGE param- 
eter. 


2. Replace the use of the BSDS method of access. This can be 
done be using explicit archive data set ddnames and/or 
active log data set ddnames in the JCL used to invoke the 
user-written application program. 


00D10019 


Explanation: The DB2 Stand-Alone Log Services OPEN proc- 
essing macro (DSNJSLR) issued this reason code. AVSAM 
OPEN error occurred while opening the Bootstrap data set 
(BSDS). The error was determined to be one which could be 
corrected by use of an AMS VERIFY, but the VERIFY also failed. 


| Internal DB2 information | 


This reason code is issued by the following CSECT(s): 
DSNJRS04 


lis 2 End of Internal DB2 Information Ff el 


System Action: In response to the DSNJSLR FUNC = OPEN call, 
DB2 places a return code of 12 in register 15 and a reason code 


of 00D10019 in register 0. No abend is issued by the Stand- 


Alone Log Services CSECT (DSNJRSO1), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the OPEN request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM return code from the original VSAM OPEN error is 
placed in SLRFRG15. The ACB error code (ACBERFLG) from 
the ACB used in the original VSAM OPEN operation is placed in 
SLRFERCD. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM OPEN error returned in 
SLRFRG15, and the ACB error code returned in SLRFERCD. 
take appropriate action, and resubmit the FUNC = OPEN 
request. 


00D10020 . 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The end of 
data has been reached (end of the-log, end of the user-specified 
log data set(s), or end of the log RBA range specified by the 
RANGE parameter). 


:.o°. Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO2, DSNJRSO3 


a End of Interna! DB2 information 6 ee 


System Action: In response to the DSNJSLR FUNC = GET call, 
DB2 places a return code of 4 in register 15 and a reason code 
of 00D10020 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: This is not an error; rather, 
this reason code denotes a normal end of data condition. No 
action is necessary. 


00D10021 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. A gap in the 
log RBA range has been encountered when switching !og data 
sets, indicating missing log records. 


This condition may or may not be intentional on the part of the 
user. Normally, a continuous set of log records are supplied as 
input by the ACTIVEn and ARCHIVE ddnames in the user’s JCL. 
If a log data set was intentionally (or unintentionally) removed, 
this condition will arise. 


ae : “< Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRS02 


at End of Internal DB2 Information inieas 5 


System Action: In response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 4 in register 15 and a reason code 


00D10020 — 00D10022 


of 00D10021 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). A 
pointer to the next log record following the gap is placed in 
SLRFFRAD. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason Code, possibly by termi- 
nating the execution of the user program. 


For additiona! details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: As mentioned above, this may 
or may not be an intentional error. Check the user’s JCL to 
ensure that a continuous string of log records has been sup- 
plied. If the BSDS method is being used, use the Print Log Map 
(DSNJU004) utility to examine the RBA ranges as recorded in 
the BSDS, and note any RBA gaps which may have resulted 
from the deletion of an active log data set or an archive log data 
set. 


If it appears that a log error may have occurred, execute the 
Log Print Utility (DSN1LOGP) to attempt to obtain a detailed 
report of the log record(s) associated with the failure. If the 
DSNILOGP utility fails, refer to Section 5 (Volume 2) of Adminis- 
tration Guide for information about recovery from log failures. 


00D10022 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. A gap in the 
log RBA range has been encountered when switching log data 
sets, indicating missing log records, and the log RBA of the 
next record following the gap is greater than the end RBA of the 
RBA range specified by the RANGE parameter. 


This condition may or may not be intentional on the part of the 
user. Normally, a continuous set of log records are supplied as 
input by the ACTIVEn and ARCHIVE ddnames in the user’s JCL. 
If a log data set was intentionally (or unintentionally) removed, 
this condition wil! arise. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO03, DSNJRS04 


———— End of Internal DB2 Information _ 


System Action: In response to the DSNJSLR FUNC =GET call, 
DB2 places a return code of 8 in register 15 and a reason code 
of 00D10022 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). A 
pointer to the next log record following the gap is placed in 
SLRFFRAD. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 
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00D10023 — 00D10025 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: As mentioned above, this may 
or may not be an intentional error. Check the RBA range speci- 
fied on the RANGE parameter to determine if the end RBA value 
was in error. Check the user’s JCL to ensure that a continuous 
string of log records has been supplied. If the BSDS method is 
being used, use the Print Log Map (DSNJU004) utility to 
examine the RBA ranges as recorded in the BSDS, and note 
any RBA gaps which may have resulted from the deletion of an 
active log data set or an archive log data set. 


If it appears that a log error may have occurred, execute the 
Log Print Utility (DSN1LOGP) to attempt to obtain a detailed 
report of the log record(s) associated with the failure. If the 
DSN1ILOGP utility fails, refer to Section 5 (Volume 2) of Adminis- 
tration Guide for information about recovery from log failures. 


00D10023 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. A gap in the 
log RBA range has been encountered, and a conditional restart 
record has been found beyond a conditional restart truncation 
point. This condition exists when a log RBA gap was inten- 
tionally forced by the user as part of log truncation during con- 
ditional restart. 


| ~~~ _ Internal DB2 Information ae 


This reason code is issued by the following CSECT(s): 
DSNJRSO2 


aaa End of Internal DB2 Information nr 


System Action: In response to the DSNJSLR FUNC =GET call, 
DB2 places a return code of 4 in register 15 and a reason code 
of 00D10023 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The length, address, and RBA of the conditional restart record 
are placed in fields SLRFRCLL, SLRFFRAD and SLRFRBA, 
respectively. 


The Stand-Alone Log Services program is under the contro! of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Use the Print Log Map 
(DSNJU004) utility to examine the conditional restart control 
records and the RBA ranges of log data sets. Note any RBA 
gaps which may have resulted from the truncation of the log 
during a conditional restart. 


If it appears that a log error may have occurred, execute the 
Log Print Utility (DSN1LOGP) to attempt to obtain a detailed 
report of the log record(s) associated with the failure. If the 
DSNI1LOGP utility fails, refer to Section 5 (Volume 2) of Adminis- 
tration Guide for information about recovery from log failures. 
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00D10024 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. A log RBA 
sequence error has occurred. The RBA of the previous log 
record is greater than the RBA of the current log record. 


ie Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


———o End of Internal DB2 Information ie ee 


System Action: In response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 8 in register 15 and a reason code 
of 00D10024 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). A 
pointer to the next log record following the gap is placed in 
SLRFFRAD. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: The DD statements in the 
user’s Job Control Language (JCL) must specify the log data 
sets in ascending log RBA range order. If both ARCHIVE and 
ACTIVEn DD statements are included, the first archive data set 
must contain the lowest log RBA value. 


Use the Print Log Map (DSNJU004) utility to obtain a listing of 
the RBA ranges associated with each archive log data set and 
active log data set. if necessary: 


¢ Adjust the concatenation sequence of the archive data sets 
in the user’s JCL to ensure that the log records are read in 
ascending RBA sequence. 


¢ Adjust the order of the active log data sets such that the 
RBA range is arranged in ascending order, starting with the 
ACTIVE1 ddname, and progressing through the ACTIVEn 
ddname. 


Following the above adjustments, resubmit the user’s JCL. 


00D10025 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. A VSAM 
error occurred while reading an active log data set. 


— ” internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


[snd of internal DB2 Information ____——_—i 


System Action: In response to the DSNJSLR FUNC =GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D10025 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRSO1), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM GET error return code is placed in SLRFRG15. The 
RPL error code (RPLERRCD) is placed in SLRFERCD. The 
ddname of the data set on which the activity occurred is placed 
in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM GET error returned in 
SLRFRG15, and the RPL error code returned in SLRFERCD. 
Take appropriate action to correct the error. 


00D10026 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing was unable to locate a log data set containing the 
requested RBA. 


—_ = — Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJRSO04 


re End of Internal DB2 Information 2 eee 


System Action: In response to the DSNJSLR FUNC =GET call, 
DB2 places a return code of 8 in register 15 and a reason code 
of 00D10026 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The RBA for which the GET request failed is placed in 
SLRFRBA. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: There could be several 
reasons for this error: 


¢ The RBA range supplied in the RANGE parameter may have 
exceeded the upper or lower bound of RBAs available on 
ali active log data sets and all archive log data sets. This 
will normally occur when the user has specified the Boot- 
strap data set (BSDS) method in the JCL. 


00D10026 — 00D1002A 


* The RBA range supplied in the RANGE parameter may have 
exceeded the upper or lower bound of RBAs available on 
the active log data sets and/or archive log data sets sup- 
plied in the user’s JCL. This will occur when the user has 
supplied log data sets using the ACTIVEn and ARCHIVE 
ddnames. 


To resolve the problem, use the Print Log Map (DSNJU004) 
utility to obtain a listing of the archive and active log data sets, 
and their corresponding RBA ranges. Check the user’s JCL 
and the user’s RANGE parameter to ensure that they are in 
harmony with one another. Correct the JCL and RANGE param- 
eters as necessary, and rerun the application. 


00D10027 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. A VSAM 
error occurred while reading the Bootstrap data set (BSDS). 


~~~ Internal DB2 Information ~ | 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


[send of internal DB2 Information ___| 


System Action: In response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D10027 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM GET error return code is piaced in SLRFRG15. The 
RPL error code (RPLERRCD) is placed in SLRFERCD. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM GET error returned in 
SLRFRG15, and the RPL error code returned in SLRFERCD. 
Take appropriate action to correct the error. 


00D1002A 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing has requested an RBA in an active log data set 
which was previously not opened. A VSAM OPEN error 
occurred while opening the active log data set. 


| internal DB2 Information = | 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


{Lo End of Internal DB2 information _ 
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00D1002B — 00D1002C 


System Action: In response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D1002A in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the resulis of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM OPEN error return code is placed in SLRFRG15. The 
ACB error code (ACBERFLG) is placed in SLRFERCD. The 
ddname of the data set on which the activity occurred is placed 
in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM OPEN error returned in 
SLRFRG15, and the ACB error code returned in SLRFERCD. 
Take appropriate action, and then resubmit the application job. 


00D1002B 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing has requested an RBA in an active log data set 
which was previously not opened. A VSAM OPEN error 
occurred while opening the active log data set. The error was 
determined to be one which could be corrected; however, a 
system error occurred while executing an MVS TESTCB macro 
to determine whether the active log data set which had just 
been opened was a VSAM ESDS data set or a VSAM LDS data 
set. 


| 7 Internal DB2 Information ~—————sssS | 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


Ui ee End of Internal DB2 Information eee 


System Action: In response to the DSNJSLR FUNC =GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D1002B in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM return code from the original VSAM OPEN error is 
placed in SLRFRG15. The ACB error code (ACBERFLG) from 
the ACB used in the original VSAM OPEN operation is placed in 
SLRFERCD. The ddname of the data set on which the activity 
occurred is placed in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
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return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM OPEN error returned in 
SLRFRG15, and the ACB error code returned in SLRFERCD. 
Take appropriate action, and resubmit the application job. 


If the SLRFERCD field contains X'1001' (decimal 4097), then the 
error is the result of an inconsistency between the TESTCB 
parmlist generated in DSNJRSO3 and the level of MVS under 
which the application program was executed. Contact IBM for 
assistance if SLRFERCD reflects this value. 


00D1002C 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing has requested an RBA in an active log data set 
which was previously not opened. A VSAM OPEN error 
occurred while opening the active log data set. The error was 
determined to be one which could be corrected by use of an 
AMS VERIFY, but the AMS VERIFY failed. 


[F ~~ internal DB2 Information rt] 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


a End of Internal DB2 Information eee 


System Action: In response to the DSNJSLR FUNC= GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D1002C in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRSO1), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM return code from the original VSAM OPEN error is 
placed in SLRFRG15. The ACB error code (ACBERFLG) from 
the ACB used in the original VSAM OPEN operation is placed in 
SLRFERCD. The ddname of the data set on which the activity 
occurred is placed in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM OPEN error returned in 
SLRFRG15, and the ACB error code returned in SLRFERCD. 
Take appropriate action, and resubmit the application job. 


00D1002D 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing has requested an RBA in an active log data set 
which was previously not opened. A VSAM OPEN error 
occurred while opening the active log data set. The open error 
was corrected by use of an AMS VERIFY, but a subsequent 
attempt to reposition the VSAM pointer back to the beginning of 
the active log data set (via AMS POINT) failed. 


i -<= internal DB2 Information ~————— 7 | 


This reason code is issued by the following CSECT(s): 
DSNJRS03 


| Ss End of Internal DB2 Information ____——_— 


System Action: In response to the DSNJSLR FUNC =GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D1002D in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The VSAM return code from the original VSAM OPEN error is 
placed in SLRFRG15. The ACB error code (ACBERFLG) from 
the ACB used in the original VSAM OPEN operation is placed in 
SLRFERCD. The ddname of the data set on which the activity 
occurred is placed in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the OS/VS Virtual 
Storage Access Method (VSAM) Programmer's Guide to deter- 
mine the meaning of the VSAM OPEN error returned in 
SLRFRG15, and the ACB error code returned in SLRFERCD. 
Take appropriate action (in most cases, the problem can be 
solved by use of an AMS VERIFY against the active log data set 
named in the SLRFDDNM field of the SLRF). Once the problem 
is solved, resubmit the application job. 


00D10030 


Explanation: The DB2 Stand-Alone Log Services GET and 
CLOSE processing macro (DSNJSLR) issued this reason code. 
The Stand-Alone Log Services uses a request block to establish 
communication between itself and the invoking application 
program. The address to the request block is returned to the 
application application program on a FUNC = OPEN call, and is 
required for all subsequent stand-alone FUNC = GET and 
FUNC = CLOSE calls in the RBR parameter. This reason code is 
returned to the invoking application when the RBR does not 
address a valid stand-alone request block. Subsequenily, the 
application program’s request cannot be processed. 


00D1002D — 00D10031 


| internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO1 


be End of Internal DB2 Information all 


System Action: In response to the DSNJSLR FUNC =GET or 
FUNC =CLOSE call, DB2 places a return code of 8 in register 15 
and a reason code of 00D10030 in register 0. No abend is 
issued by the Stand-Alone Log Services CSECT (DSNJRS0O1), 
and no information is written to SYS1.LOGREC data set. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: On a FUNC= OPEN call, the 
RBR value is returned in register 1. The application program 
must preserve this value for all subsequent stand-alone 
FUNC = GET and FUNC=CLOSE calls. Due to an application 
program logic error in the program which invokes the stand- 
alone log services, the RBR value has been compromised. 
Repair the application program, and resubmit the application 
job. 


00D10031 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing has requested an RBA in a log data set which was 
previously not opened. The user’s Job Control Language (JCL) 
has specified that the Bootstrap data set (BSDS) be used as the 
guide to determining which log data sets are required. An 
attempt to dynamically allocate the appropriate log data set (via 
MVS SVC 99) failed. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO5 


ene End of internal DB2 Information sre | 


System Action: In response to the DSNJSLR FUNC = GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D10031 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRSO1), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The SVC 99 error code (S99ERROR) and information code 
(S99INFO) are placed in the SLRFRC and SLRFINFO fields, 
respectively. The ddname of the data set on which the activity 
occurred is placed in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


DB2 Codes 4-61 











00D10040 — 00D10048 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the SPL: Job Manage- 
ment (MVS/XA, MVS/ESA) to determine the meaning of the SVC 
99 error code (S99ERROR) returned in SLRFRG15, and SVC 99 
information code (S99INFO) returned in SLRFINFO. Take the 
appropriate action to correct the error, and resubmit the appli- 
cation job. 


00D10040 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing has requested an RBA in an archive log data set 
which was previously not opened. An attempt is made to open 
the second file on the archive log tape (the first file normally 
contains the Bootstrap data set, while the second is normally 
the archive log data set). If this first attempt failed because the 
archive log data set was not the second file on an archive tape, 
then the RDJFCB macro is used to change the data set 
sequence number from the default value of 2 to a value of 1, 
before the OPEN is attempted again. This reason code is gen- 
erated when an error was returned from the RDJFCB macro. 


| Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


er End of Internal DB2 Information ears 


System Action: In response to the DSNJSLR FUNC =GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D10040 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The RDJFCB error code is placed in SLRFRG15. The ddname of 
the data set on which the activity occurred is placed in 
SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Refer to the SPL: Job Manage- 
ment (MVS/XA, MVS/ESA) to determine the meaning of the 
ROJFCB error code returned in SLRFRG15. Take the appro- 
priate action to correct the error, and resubmit the application 
job. 


00D10044 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The GET 
processing has requested an RBA in an archive log data set 
which was previously not opened. The attempt to open the 
archive fog data set failed. 
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a ; “Internal DB2 Information ~ i 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


be et dees End of Internal DB2 Information ee ee eee | 


System Action: In response to the DSNJSLR FUNC = GET cail, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D10044 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The ddname of the data set on which the activity occurred is 
placed in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Determine the cause of the 
QSAM OPEN error, take the appropriate action to correct the 
error, and resubmit the application job. 


00D10048 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. A QSAM 
GET error occurred while reading an archive log data set. 


: = ~~~ Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRS03 


re End of Internal DB2 Information tee esa 


System Action: In response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 12 in register 15 and a reason code 
of 00D10048 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The ddname of the data set on which the activity occurred is 
placed in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Determine the cause of the 
QSAM GET error, take the appropriate action to correct the 
error, and resubmit the application job. 





00D10050 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The Boot- 
strap data set (BSDS) was erroneously specified as one of the 
ARCHIVE data sets in the user’s Job Control Language (JCL). 
Consequently, the GET request failed. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


ar re End of Internal DB2 Information ae 


System Action: In response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 8 in register 15 and a reason code 
of 00D10050 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRSO1), and no information is 
written to SYS1.LOGREC data set. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The RBA of the requested log record control interval is placed 
in SLRFRBA. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Examine the user’s JCL, and 
remove the occurrence of the BSDS data set as one of the con- 
catenated ARCHIVE data sets. Resubmit the application job. 


00D10061 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The log 
record control interval (Cl) requested by the application 
program was read successfully from an active log data set or 
an archive log data set. However, the physical record length 
returned from reading the Cl is not the expected length. The 
GET function will complete, but will issue this reason code as a 
warning. 


The length of a log Cl in an active log data set is expected to be 
4096 bytes. The length of a log Cl in an archive log data set is 
expected to be 4089 bytes. 


| aa Internal DB2 information ” =A 


This reason code is issued by the following CSECT(s): 
DSNJRSO3 


re End of Internal DB2 Information | 


System Action: in response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 4 in register 15 and a reason code 
of 00D10061 in register 0. No abend is issued by the Stand- 

Alone Log Services CSECT (DSNJRS01), and no information is 


00D10050 — 00D10062 


written to SYS1.LOGREC data set. The GET function will com- 
plete, but will issue this reason code as a warning. 


information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The length and address of the Cl are placed in fields SLRFRCLL 
and SLRFFRAD, respectively. The RBA associated with the Cl 
is placed in SLRFRBA. The ddname of the data set on which 
the activity occurred is placed in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
an non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: The RDF/CIDF control infor- 
mation in the Cl has been compromised. If the SLRFRCLL field 
indicates a value greater than expected, then the data within 
the Cl can still be used by the application program. If the 
SLRFRCLL field indicates a value less than expected, then the 
data within the Cl in all likelihood can still be used, but with 
caution (additional error checking routines may be required by 
the user program). 


00D10062 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The 
requested record was found to be a middle spanned record 
segment, but a preceding first record segment does not exist. 
The GET function will complete, but will issue this reason code 
as a warning. 


| interna! DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJRSO2 


Pose End of Internal DB2 Information _ 


System Action: In response to the DSNJSLR FUNC = GET call, 
DB2 places a return code of 4 in register 15 and a reason code 
of 00010062 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. The GET function will com- 
plete, but wil! issue this reason code as a warning. 


information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The length and address of the requested record are placed in 
fields SLRFRCLL and SLRFFRAD, respectively. The RBA asso- 
ciated with the log record segment is placed in SLRFRBA. The 
ddname of the data set on which the activity occurred is placed 
in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


DB2 Codes 4-63 


00D10063 — 00D10210 


System Programmer Response: Several possibilities exist for 
the cause of this condition: 


* The Recovery Log Manager component of DB2 did not ori- 
ginally construct the LRH properly. 


* The fog record header (LRH) for the log record segment 
was damaged after it was written by the DB2 subsystem. 


e The application program continued to process after receipt 
of a 00D10021 reason code (gap in the log). 


If the error was caused by the application program, modifica- 
tions to the application program may be required. 


If the error is a suspected DB2 problem, run the Log Print 
(DSNILOGP) utility, specifying a range of RBAs which would 
encompass the problem RBA. Determine if the LRH of the log 
record segment is truly in error by looking at the record seg- 
ments directly preceding and after the record segment in ques- 
tion. 


00D10063 


Explanation: The DB2 Stand-Alone Log Services GET proc- 
essing macro (DSNJSLR) issued this reason code. The 
requested record was found to be a fast spanned record 
segment, but a preceding first record segment does not exist. 
The GET function will complete, but will issue this reason code 
as a warning. 


hing Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJRS02 


(eat tees End of Internal DB2 Information sie 


System Action: In response to the DSNJSLR FUNC=GET call, 
DB2 places a return code of 4 in register 15 and a reason code 
of 00D10063 in register 0. No abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. The GET function will com- 
plete, but will issue this reason code as a warning. 


Information about the results of the GET request is also 
returned in the Stand-Alone Log GET Feedback Area (SLRF). 
The length and address of the requested record are placed in 
fields SLRFRCLL and SLRFFRAD, respectively. The RBA asso- 
ciated with the log record segment is placed in SLRFRBA. The 
ddname of the data set on which the activity occurred is placed 
in SLRFDDNM. 


The Stand-Alone Log Services program is under the control of a 
user-written program that uses the DSNJSLR macro. The user 
program must therefore anticipate and react to a non-zero 
return code and a non-zero reason code, possibly by termi- 
nating the execution of the user program. 


For additional details about the Stand-Alone Log Services, 
including a sample of an application program which reacts to 
non-zero return codes and non-zero reason codes, refer to 
Section 5 of Diagnosis Guide and Reference. 


System Programmer Response: Several possibilities exist for 
the cause of this condition: 


e The Recovery Log Manager component of DB2 did not ori- 
ginally construct the log record header (LRH) properly. 


¢ The LRH for the log record segment was damaged after it 
was written by the DB2 subsystem. 


¢ The application program continued to process after receipt 
of a 00D10021 reason code (gap in the log). 
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If the error was caused by the application program, modifica- 
tions to the application program may be required. 


lf the error is a suspected DB2 problem, run the Log Print 
(DSN1LOGP) utility, specifying a range of RBAs which would 
encompass the problem RBA. Determine if the LRH of the log 
record segment is truly in error by looking at the record seg- 
ments directly preceding and after the record segment in ques- 
tion. 


Recovery Log 


00D10101 


Explanation: The ENDRBA value specified in the control state- 
ment was either greater or less than any known RBA, but cold 
start was not specified for the conditional restart. 


Internal DB2 Information ~———————<CST | 


This abend reason code is issued by the following CSECT(s): 
DSNJW306 


Ls End of internal DB2 information 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Run the Change Log Inventory 
utility with a CRESTART control statement that has an RBA 
value known to the system in the BSDS, or that has the ENDRBA 
and STARTRBA specifying the same RBA (cold start). 


Refer to Section 5 (Volume 2) of Administration Guide for more 
information. 


00D10210 


Explanation: An unsuccessful completion of a SET WRITE 
CURSOR has occurred. An invalid write cursor ID was sup- 
plied. 


| Internal DB2 Information Z | 


This abend reason code is issued by the following CSECT(s): 
DSNJW002 


————e End of Internal DB2 Information Si =] 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.L.OGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10220 


Explanation: An unsuccessful compietion of a LOG WRITE has 
occurred. An invalid write cursor ID was supplied. 


= Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJWO001 


[erage tte = End of Internal DB2 Information fe we 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10221 


Explanation: An unsuccessful completion of a LOG WRITE has 
occurred. An invalid number of areas was specified. 


== —_ Internal DB2 Information ~ 


This abend reason code is issued by the following CSECT(s): 
DSNJWO001 


Peete eens. End of internal DB2 Information Rae 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10222 


Explanation: An unsuccessful completion of a LOG WRITE has 
occurred. The record length specified was greater than 32767. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJW001 


ene aa ees End of Internal DB2 Information eee || 


00D10220 — 00D10231 


System Action: An execution unit writes a record 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10223 


Explanation: There was an attempt to modify a log data set 
while doing a conditional restart with CSRONLY specified. 


internal DB2 information as 1 


This abend reason code is issued by the following CSECT(s): 
DSNJB001, DSNJW001 


Wo Stee Poe End of Internal DB2 Information fe 


System Action: DB2 startup is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: If a complete DB2 startup is 
desired, remove CSRONLY from the control statement. Restart 
DB2. 


00D10230 


Explanation: A CHECK LOG was issued and the log RBA speci- 
fied in the macro had not been written to DASD at the time. 


= ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJW004 


[End of internal DB2 Information 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10231 


Explanation: An unsuccessful completion of a CHECK LOG has 
occurred. The specified RBA is beyond the end of the log. 


| internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJW004 


I. oe End of Internal DB2 Information eee 


DB2 Codes 4-65 


00D10240 — 00D10252 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10240 


Explanation: An unsuccessful completion of a CLOSE LOG 
FOR WRITE has occurred. An invalid write cursor ID was sup- 
plied. 


oS Internal DB2 Information ~~ 


This abend reason code is issued by the following CSECT(s): 
DSNJW002 


| End of internal DB2 Information ___——_— 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10250 


Explanation: An unrecoverable error occurred while updating 
either the BSDS or the MVS catalog to reflect changes in active 
log data sets. 


| Internal DB2 Information so z| 


This abend reason code is issued by the following CSECT(s): 
DSNJW307 


clos cee cs End of Internal DB2 Information Settee tee oe 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. DB2 then terminates 
abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


4-66 DB2 Messages and Codes 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Correct the error, and restart DB2. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, see abend reason code '00D10252' 
for a description of the information recorded in the variable 
recording area (VRA) of the SDWA. For information about 
finding the SDWA, refer to Section 5 of Diagnosis Guide and 
Reference. 


Examine the console log for a DSNJxxxx message preceding 
this abend to determine whether the error was a BSDS error or 
an MVS catalog update error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 15. 


00D10251 


Explanation: An unrecoverable error occurred in the log buffer 
writer. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJW008 


De es End of Internal DB2 Information be Se | 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. DB2 then terminates 
abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. 


This error is usually caused by a previous error that was 
recorded on SYS1.LOGREC and produced an SVC dump. The 
SYS1.LOGREC entries and SVC dump should be examined to 
determine the primary error that occurred. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, see abend reason code '00D10252' 
for a description of the information recorded in the variable 
recording area (VRA) of the SDWA. For information about 
finding the SDWA, refer to Section 5 of Diagnosis Guide and 
Reference. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 15. 





00D10252 


Explanation: This abend reason code is used to define the 
format of the information recorded in the variable recording 
area (VRA) of the SDWA. 


| ~ Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNJWO008 


Ls End of internal DB2 Information _____——_— 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. 


Operator Response: Collect the SYS1.L.OGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, the following information is con- 
tained in the variable recording area (VRA) of the SDWA: 


* Reason code '00D10252' stored with key = VRARC. 

¢ The log buffer writer recovery tracking area is stored with 
key =VRARRP. These fields in the VRA are described by 
the system mapping macro IHAVRA. 


For information about finding the SDWA, refer to Section 5 of 
Diagnosis Guide and Reference. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 


00D10253 


Explanation: An application program check occurred in an 
MVCP instruction that attempted to move a parameter list or 
other data from the caller’s address space to the recovery log 
manager address space. 


| Internai DB2 Information ee | 


This abend reason code is issued by the following CSECT(s): 
DSNJRO01, DSNJW001, DSNJW002 


[ie open cee End of internal DB2 Information ee eee 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.L.OGREC and 
SVC dump. Examine the area from which data was to be 
moved. It may be in the wrong key, or the address may be the 
cause of the problem. The failing instruction has a DA opcode 
and indicates the registers showing address and length to be 
moved. 


Probiem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10254 


Explanation: An application program check occurred in an 
MVCS instruction that attempted to move data from the 
recovery log manager address space to the caller’s address 
space. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJR103 


Reaeseae Sues End of Internal DB2 Information es ee 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. 


00D10253 — 00D10261 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Examine the area to which data was to be moved. 
It may be in the wrong key, or the address may be the cause of 
the problem. The failing instruction has a DB opcode and indi- 
cates the registers showing address and length to be moved. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10255 


Explanation: DSNJRO008 attempted to resume the waiting exe- 
cution unit, and a failure occurred leaving the state of the 
resume indoubt. 


internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJRE08, DSNJW206 


a End of internal DB2 Information eee 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The DB2 subsystem 
then terminates to avoid leaving the execution unit in a state of 
indefinite suspension. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. Restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'Dt')” 
on page 4-55. In addition, register 6 has the address of the 
execution block (EB). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10261 


Explanation: While scanning the records and record segments 
in a log control interval (Cl), it was discovered that the forward 
record chain was broken. This condition is the result of an 
incorrect record length in the log record header of some record 
in the fog Cl. 


[ Interna! DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJRO05, DSNJWO009, DSNJW107 


US ea End of Internal DB2 Information Geeta esl 


System Action: This reason code can be issued by an active 
DB2 subsystem as the log buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive log data set. 


DB2 Codes 4-67 


00D10262 — 00D10262 


If the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


¢ {fthe error was detected by DSNJOFF1, then the archiving 
of the active fog data set is terminated and the faulty active 
log data set is marked 'stopped'. 


° Ifthe error was detected by DSNJROOS5, then message 
DSNJ012I is issued and the calling agent is terminated. 


¢ Ifthe error was detected by DSNJW009, then message 
DSNJO12I is issued and the DB2 subsystem is terminated. 


* ifthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


If this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC = GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10261 in register 0. Infor- 
mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The RBA of 
the record in error is placed in SLRFRBA. The address and 
length of the Cl which contains the errant log record header are 
placed in SLRFFRAD and SLRFRCLL, respectively. The 
ddname of the data set on which the activity occurred is placed 
in SLRFDDONM. 


For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


Operator Response: if the reason code is issued by an active 
DB2 subsystem, collect the SYS1.L.OGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: if the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


Problem Determination: 
active DB2 subsystem: 


If the reason code is issued by an 


¢ RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


¢ Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


* Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


* Obtain a DSN1LOGP detail report containing the log 
record(s) associated with the failure. 


if the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 
written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10262 


Explanation: While scanning a log control interval (Cl), the 
offset to the last record or record segment in the Cl was found 
to be incorrect. 
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ft. = Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJROO5, DSNJWO009, DSNJW107 


| ee aeeaee End of Interna! DB2 Information are 


System Action: This reason code can be issued by an active 
DB2 subsystem as the log buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive log data set. 


If the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


e ifthe error was detected by DSNJOFF1, then the archiving 
of the active log data set is terminated and the faulty active 
log data set is marked 'stopped'. 


¢ Ifthe error was detected by DSNJRO05, then message 
DSNJ012I is issued and the calling agent is terminated. 


e {fthe error was detected by DSNJW009, then message 
DSNJ012I is issued and the DB2 subsystem is terminated. 


¢ ifthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


If this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC =GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10262 in register 0. Infor- 
mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The RBA of 
the beginning of the Cl is placed in SLRFRBA. The address and 
length of the Cl are placed in SLRFFRAD and SLRFRCLL, 
respectively. The ddname of the data set on which the activity 
occurred is placed in SLRFDDNM. 


For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


Operator Response: Ifthe reason code is issued by an active 
DB2 subsystem, collect the SYS1.LOGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: /f the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


Problem Determination: If the reason code is issued by an 
active DB2 subsystem: 


¢ RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


e Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


e Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


¢ Obtain a DSN1ILOGP detail report containing the log 
record(s) associated with the faiiure. 


If the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 


written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10263 


Explanation: While scanning a log control interval (Cl), the 
VSAM RDF/CIDF control information was found to be incorrect. 


— Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJRO05, DSNJW009, DSNJW107 


a End of Internal DB2 Information ee al 


System Action: This reason code can be issued by an active 
DB2 subsystem as the log buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive log data set. 


If the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


¢ Ifthe error was detected by DSNJOFF1, then the archiving 
of the active log data set is terminated and the faulty active 
log data set is marked 'stopped'. 


¢ Ifthe error was detected by DSNJRO005, then message 
DSNJ012I is issued and the calling agent is terminated. 


¢ Ifthe error was detected by DSNJWO009, then message 
DSNJ012! is issued and the DB2 subsystem is terminated. 


¢ Ifthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


lf this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC = GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10263 in register 0. Infor- 
mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The RBA of 
the beginning of the Cl is placed in SLRFRBA. The address and 
length of the Cl are placed in SLRFFRAD and SLRFRCLL, 
respectively. The ddname of the data set on which the activity 
occurred is placed in SLRFDDNM. 


For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


Operator Response: Ifthe reason code is issued by an active 
DB2 subsystem, collect the SYS1.LOGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: If the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


Problem Determination: 
active DB2 subsystem: 


If the reason code is issued by an 


* RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


* Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


00D10263 — 00D10264 


e Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


* Obtain a DSNILOGP detail report containing the log 
record(s) associated with the failure. 


If the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 
written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10264 


Explanation: While scanning a log control interval (Cl), the 
beginning log RBA of the Cl was not the expected RBA. 


| Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJROO5, DSNJW009, DSNJW107 


eee eee End of Internal DB2 Information eas 


System Action: This reason code can be issued by an active 
DB2 subsystem as the log buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive log data set. 


If the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


¢ Ifthe error was detected by DSNJOFF1, then the archiving 
of the active log data set is terminated and the faulty active 
log data set is marked 'stopped'. 


¢ Ifthe error was detected by DSNJR005, then message 
DSNJ012I is issued and the calling agent is terminated. 


e Ifthe error was detected by DSNJW009, then message 
DSNJO012I is issued and the DB2 subsystem is terminated. 


¢ Ifthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


If this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC =GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10264 in register 0. Infor- 
mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The expected 
RBA of the beginning of the Cl is placed in SLRFRBA. The 
address and length of the Cl are placed in SLRFFRAD and 
SLRFRCLL, respectively. The ddname of the data set on which 
the activity occurred is placed in SLRFDDNM. 


For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


Operator Response: If the reason code is issued by an active 
DB2 subsystem, collect the SYS1.L.OGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: If the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


DB2 Codes 4-69 








00D10265 — 00D10266 


Problem Determination: 
active DB2 subsystem: 


If the reason code is issued by an 


* RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


¢ Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


¢ Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


* Obtain a DSN1LOGP detail report containing the log 
record(s) associated with the failure. 


if the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 
written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10265 


Explanation: While scanning the records and record segments 
in a log control interval (Cl), it was discovered the backward 
record chain was broken. This condition is the result of an 
incorrect record length in the log record header of some record 
in the log Cl. 


| Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJRO05, DSNJW009, DSNJW107 


tse ee ats End of Internal DB2 Information ees eee 


System Action: This reason code can be issued by an active 
DB2 subsystem as the log buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive log data set. 


If the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


e Ifthe error was detected by DSNJOFF1, then the archiving 
of the active log data set is terminated. 


* Ifthe error was detected by DSNJROO5, then message 
DSNJ012i is issued and the calling agent is terminated. 


¢ Ifthe error was detected by DSNJW009, then message 
DSNJ012I is issued and the DB2 subsystem is terminated. 


e Ifthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


If this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC = GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10265 in register 0. Infor- 
mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The RBA of 
the record in error is placed in SLRFRBA. The address and 
length of the Cl are placed in SLRFFRAD and SLRFRCLL, 
respectively. The ddname of the data set on which the activity 
occurred is placed in SLRFDDNM. 


For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


4-70 DB2 Messages and Codes 


Operator Response: If the reason code is issued by an active 
DB2 subsystem, collect the SYS1.LOGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: If the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


Problem Determination: 
active DB2 subsystem: 


If the reason code is issued by an 


¢ RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


¢ Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


¢ Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


* Obtain a DSN1LOGP detail report containing the log 
record(s) associated with the failure. 


If the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 
written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10266 


Explanation: While scanning a log control interval (Ci), a unit 
of recovery ID or LINK RBA in some record was found to be 
inconsistent with the beginning log RBA of the CI. 


[ ~~ Internal DB2 Information ” a | 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJROO5, DSNJW009, DSNJW107 


(eee End of Internal DB2 Information a 


System Action: This reason code can be issued by an active 
DB2 subsystem as the fog buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive log data set. 


lf the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


e Ifthe error was detected by DSNJOFF1, then the archiving 
of the active log data set is terminated and the faulty active 
log data set is marked 'stopped'. 


e Ifthe error was detected by DSNJROOS5, then message 
DSNJ012!I is issued and the calling agent is terminated. 


e Ifthe error was detected by DSNJW009, then message 
DSNJ012l is issued and the DB2 subsystem is terminated. 


e {fthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


If this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC = GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10266 in register 0. Infor- 





mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The RBA of 
the log record with the invalid RBA is placed in SLRFRBA. The 
address and length of the Cl are placed in SLRFFRAD and 
SLRFRCLL, respectively. The ddname of the data set on which 
the activity occurred is placed in SLRFDDNM. 


For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


Operator Response: If the reason code is issued by an active 
DB2 subsystem, collect the SYS1.L.OGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: |f the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


Problem Determination: 
active DB2 subsystem: 


If the reason code is issued by an 


¢ RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


e Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


¢ Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


* Obtain a DSN1LOGP detail report containing the log 
record(s) associated with the failure. 


If the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 
written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10267 


Explanation: While scanning a log control interval (Cl), a 
middle or last spanned record segment was not the first 
segment contained in the log Cl. 


Internal DB2 Information —-— =a 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJRO05, DSNJW009, DSNJW107 


eee eee: End of Internal DB2 Information ee clea | 


System Action: This reason code can be issued by an active 
DB2 subsystem as the log buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive fog data set. 


If the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


¢ ifthe error was detected by DSNJOFF1, then the archiving 
of the active log data set is terminated and the faulty active 
log data set is marked ‘stopped’. 


* If the error was detected by DSNJRO05, then message 
DSNJ012I is issued and the calling agent is terminated. 


* Ifthe error was detected by DSNJW009, then message 
DSNJ012I is issued and the DB2 subsystem is terminated. 


00D10267 — 00D10268 


° Ifthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


If this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC = GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10267 in register 0. Infor- 
mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The RBA of 
the record segment in error is placed in SLRFRBA. The 
address and length of the Cl are placed in SLRFFRAD and 
SLRFRCLL, respectively. The ddname of the data set on which 
the activity occurred is placed in SLRFDDNM. 


\ 
For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


Operator Response: If the reason code is issued by an active 
DB2 subsystem, collect the SYS1.LOGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: If the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


Problem Determination: 
active DB2 subsystem: 


If the reason code is issued by an 


¢ RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


¢ Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


¢ Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


¢ Obtain a DSN1ILOGP detail report containing the log 
record(s) associated with the failure. 


\f the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 
written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10268 


Explanation: While scanning a log control interval (Cl), a first 
or middle spanned record segment was not the last segment 
contained in the jog Cl. 


[ — Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNJOFF1, DSNJRSO1, DSNJROO5, DSNJW009, DSNJW107 


[ees End of Internal DB2 Information ete} 


System Action: This reason code can be issued by an active 
DB2 subsystem as the log buffers are scanned before they are 
written to the active log, or by the DB2 Stand-Alone Log Ser- 
vices GET processing macro (DSNJSLR) as a Cl is retrieved 
from a user-specified active or archive log data set. 


If the reason code is issued by an active DB2 subsystem, then 
an abend is issued. A diagnostic record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


DB2 Codes 4-71 


00D10269 — 00D10302 


¢ ifthe error was detected by DSNJOFF1, then the archiving 
of the active log data set is terminated and the faulty active 
log data set is marked 'stopped'. 


¢ Ifthe error was detected by DSNJRO005, then message 
DSNJO12I is issued and the calling agent is terminated. 


e Ifthe error was detected by DSNJW009, then message 
DSNJ012I is issued and the DB2 subsystem is terminated. 


¢ Ifthe error was detected by DSNJW107, then the DB2 sub- 
system is terminated. 


If this reason code is issued as the result of DB2 Stand-Alone 
Log Services GET processing, no abend is issued by the Stand- 
Alone Log Services CSECT (DSNJRS01), and no information is 
written to SYS1.LOGREC data set. Rather, in response to the 
DSNJSLR FUNC = GET call, DB2 places a return code of 4 in 
register 15 and a reason code of 00D10268 in register 0. Infor- 
mation about the results of the GET request is also returned in 
the Stand-Alone Log GET Feedback Area (SLRF). The RBA of 
the record segment in error is placed in SLRFRBA. The 
address and length of the Cl are placed in SLRFFRAD and 
SLRFRCLL, respectively. The ddname of the data set on which 
the activity occurred is placed in SLRFDDNM. 


For additional details about the Stand-Alone Log Services, refer 
to Section 5 of Diagnosis Guide and Reference. 


Operator Response: If the reason code is issued by an active 
DB2 subsystem, collect the SYS1.LOGREC and SVC dump, and 
notify the system programmer. 


System Programmer Response: If the reason code is issued by 
an active DB2 subsystem, obtain the SYS1.LOGREC and the 
SVC dump from the operator. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


Problem Determination: lf the reason code is issued by an 
active DB2 subsystem: 


* RLM standard diagnostic information is provided under 
“Recovery Log Manager Reason Codes (X'D1')” on 
page 4-55. 


* Refer to Section 5 (Volume 2) of Administration Guide for 
information about recovery from log failures. 


e Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures, with particular emphasis on 
the use of the DB2 Stand-Alone Log Services. 


¢ Obtain a DSN1LOGP detail report containing the log 
record(s) associated with the failure. 


If the reason code is issued upon return of an invocation of the 
DB2 Stand-Alone Log Services macro (DSNJSLR), then an addi- 
tional user-written exit or diagnostic routine may have to be 
written. Refer to Section 5 of Diagnosis Guide and Reference 
for additional details. 


00D10269 


Explanation: An unrecoverable error was found in one of the 
buffers, while moving the current log buffer to the static write 
buffer (‘shadow buffer') in preparation for the physical write to 
the active log. Refer to Section 5 (Volume 2) of Administration 
Guide for information about recovery from log failures. 


4-72 DB2 Messages and Codes 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJW107 


[ee tots End of Internal DB2 Information eee TL 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The subsystem 
then terminates. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided under “Recovery Log Manager Reason Codes 
(X'D1')” on page 4-55. 

Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10301 


Explanation: An unsuccessful! completion of an OPEN LOG 
FOR READ has occurred. An open log read cursor already 
exists for this execution block (EB). Only one log read cursor 
per EB is permitted. 


| Internal DB2 Information = — 5 | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO1 


Wes, ee ae End of Internal DB2 Information ye are et 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Scan the read cursor pool for a cursor with the 


.same EB, or examine through the DB2 trace for the problem. 


Trace IDs 040301 and 040302 identify OPEN entries while 040303 
and 040304 are for CLOSE. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. All log read cursors reside in a recovery log 
manager storage pool whose header address is in the log 
manager block (LMB) at LMBRCPHB. The LMB is pointed to by 
register 5. Register 6 contains the address of the EB. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10302 


Explanation: An unsuccessful completion of an OPEN LOG 
FOR READ has occurred. A valid scope was not specified. 


| tac: Internal DB2 Information ~~ | 


This abend reason code is issued by the fotlowing CSECT(s): 
DSNJROO1 


[eens ao End of Internal DB2 Information _ 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10303 


Explanation: An unsuccessful completion of an OPEN LOG 
FOR READ has occurred. An invalid log RBA range was speci- 
fied. HIGHRBA is less than LOWRBA. 


TO ~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJRO01 


{Lo End of Internal DB2 information | 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items tisted in Appendix B, 
“Problem Determination” on page X-5: 2; 5, 15. 


00D10310 


Explanation: An unsuccessful completion of a SET READ 
CURSOR RANGE has occurred. The specified log read cursor 
was not opened by the execution block submitting this request. 
All input requests must be submitted under the execution block 
that opened the cursor. 


[ oc interna! DB2 information Se 


This abend reason code is issued by the following CSECT(s): 
DSNJROO1 


[ere oe  oe End of Internal DB2 Information pat 


00D10303 — 00D10312 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, register 6 contains the address of 
the execution block (EB). All log read cursors reside ina 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10311 


Explanation: An unsuccessful completion of a SET READ 
CURSOR RANGE has occurred. An invalid write cursor ID was 
specified. 


| Internal DB2 Information : “| 


This abend reason code is issued by the following CSECT(s): 
DSNJROO1 


ns End of Internal DB2 Information eee el 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.L.OGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, all log write cursors reside ina 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBWCPHB. The LMB is 
pointed to by register 5. Read cursors are in a similar pool at 
LMBRCPHB. 


Coltect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10312 


Explanation: An unsuccessful completion of a SET READ 
CURSOR RANGE has occurred. An invalid log RBA range was 
specified. HIGHRBA is lower than LOWRBA. 


[ === Internal DB2 Information ~— 


This abend reason code is issued by the following CSECT(s): 
DSNJROO1 


ree End of Internal DB2 Information Bie ahah 


DB2 Codes 4-73 


00D10322 — 00D10325 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D10322 


Explanation: An unsuccessful completion of a LOG READ has 
occurred. MODE =DIRECT with a record matching the specified 
TYPE was not found. 


Internal DB2 Information ~— ees 


This abend reason code is issued by the following CSECT(s): 
DSNJROO03 


| send of Internal DB2 Information ______——_—| 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10323 


Explanation: An unsuccessful completion of a LOG READ has 
occurred. MODE= DIRECT with record matching the specified 
SCOPE is not found. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO3 


(Se End of Internal DB2 Information ee 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 
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Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10324 


Explanation: An unsuccessful completion of a LOG READ has 
occurred. MODE = DIRECT with record matching the specified 
CDATA is not found. 


| ~~ _ Internal DB2 Information ee 


This abend reason code is issued by the following CSECT(s): 
DSNJR003 


[pelea tonne oh cet End of Internal DB2 Information a ar 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10325 


Explanation: An unsuccessful completion of a LOG READ has 
occurred. The sum of CDATA length value and CDATA offset 
value is greater than 256. 


| a Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJROO3 


an End of Internal DB2 Information Behe oo eel 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Probiem Determination” on page X-5: 5, 15. 


00D10326 


Explanation: An unsuccessful completion of a LOG READ has 
occurred. The macro invocation specified that no wait was to 
occur because of a busy archive log data set (ADSWAIT(NO)). 
The macro invocation also specified that, rather than returning 
with a condition code (COND(NO)), an abend should be issued 
by the recovery log manager (RLM) subcomponent. The RLM 
determined that the record requested was on an archive log 
data set that was in use. 


7 Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO8 


Lo End of Internal DB2 Information ee | 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10327 


Explanation: An unsuccessful completion of a LOG READ has 
occurred because of an invalid LOGRBA value. 

MODE = DIRECT with requested RBA does not match the start of 
a fog record. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJROO3 


nee End of Internal DB2 information es 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5.of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


00D10328 


Explanation: A LOG READ completed unsuccessfully, because 
a MODE request sequence was invalid. A read request speci- 
fying a sequential MODE (any MODE except DIRECT) must be 
preceded by an open log for read, a set read cursor range, ora 
read with the same MODE parameter value. It is invalid to 
intermix read requests with different sequential mode values. 


00D10326 — 00D1032A 


Internal DB2 Information ee | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO3 


[| seEnd of internal DB2 Information _____——_—| 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Coilect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.L.OGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D10329 


Explanation: A LOG READ completed unsuccessfully, because 
an I/O error occurred while reading the log data set. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from log faijiures. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJRO03 


eter End of internal DB2 Information Saree 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.L.OGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Examine SYS1.LOGREC and 
SVC dump information. Also, examine any prior messages with 
a DSNJ prefix from the log buffer reader. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D1032A 


Explanation: An unsuccessful completion of a LOG READ has 
occurred. BSDS does not map the specified RBA into a log data 
set. Either the BSDS is in error, or the log data set has been 
deleted. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from BSDS or log failures. 
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00D1032B — 00D1032E 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJRO003 


Di cae ee End of Internal DB2 Information ee 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Also, obtain a listing of the BSDS by running the 
Print Log Map utility. Refer to Section 5 of Diagnosis Guide and 
Reference for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 15. 


00D1032B 


Explanation: Completion of a LOG READ was unsuccessful, 
because an error occurred while attempting to allocate a log 
data set. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from log failures. 


ao Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO03 


[send of internal DB2 Information 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Examine LOGREC and SVC 
dump information. Also, examine any prior messages with a 
DSNu prefix from recovery fog manager allocation processing. 


Problem Determination: RIM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D1032C 


Explanation: A LOG READ completed unsuccessfully, because 
an error occurred while opening or closing a log data set. 


Refer to Section 5 (Volume 2) of Administration Guide for infor- 
mation about recovery from log failures. 
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| Internal DB2 Information = | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO3 


ee End of internal DB2 Information ete | 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Examine LOGREC and SVC 
dump information. Also, examine prior messages from 
recovery log manager open/close processing. These messages 
have a prefix of DSNJ. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D1032D 


Explanation: An unsuccessful completion of aLOG READ has 

occurred. The specified log read cursor was not opened by the 
execution block submitting this request. All input requests must 
be submitted under the execution block that opened the cursor. 


~ Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO3 


ae End of internal DB2 Information ey, 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to the Section 5 of Diagnosis Guide and 
Reference for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, all log read cursors reside ina 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 15. 


00D1032E 


Explanation: A LOG READ completed unsuccessfully due to an 
internal error. 


| : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJR103 


(ee End of Internal DB2 Information sot ae 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Examine LOGREC and SVG 
dump information. LOG READ was passed a bad parameter 
list. The field which was detected to be in error (RDPLOPT1) is 
the third byte of the second word traced in the log manager 311 
trace entry. The RET field of this trace entry along with the 
MEPL may be used to determine which module issued the Log 
Read request. Both pieces of information are useful in isolating 
the failure. 


Probiem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 5. 


00D1032F 


Explanation: A LOG READ completed unsuccessfully because 
the high range RBA provided was not the RBA of a valid log 
record. This is an internal error. 


an a Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJR103 


a End of Internal DB2 Information eee ll 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, register 6 contains the address of 
the execution block (EB). All log read cursors reside ina 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5 and described by DSNDLMB. 


00D10330 


Explanation: An unsuccessful completion of a Close Log for 
read has occurred. The specified log read cursor was not 
opened by the execution block submitting this request. All input 
requests must be submitted under the execution block that 
opened the cursor. 


00D1032F — 00D10340 


Internal DB2 Information — 


This abend reason code is issued by the following CSECT(s): 
DSNJROO1 


[| End of Internal DB2 information Ree eee 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, register 6 contains the address of 
the execution block (EB). All log read cursors reside in a 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5 and described by DSNDLMB. 


00D10331 


Explanation: A LOG READ completed unsuccessfully because 
a LINK RBA did not point to the beginning of a LOG record. 
This is an internal error. 


i a= internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJR103 


(2 ee End of Internal DB2 Information Se eee el 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. in addition, register 6 contains the address of 
the execution block (EB). All log read cursors reside ina 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5 and described by DSNDLMB. 


00D10340 


Explanation: An unsuccessful completion of a LOG READ has 
occurred. This reflects a logic failure internal to the recovery 
log manager (RLM) subcomponent and is probably caused by a 
passed parameter list being lost. 
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00D10341 — 00D10406 


[ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJROO8 


le oe pecs End of Internal DB2 Information i 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect all relevant diagnostic materials, 
including SYS1.LOGREC, SVC dump, and console output. Notify 
the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 5, 
15. 


00D10341 


Explanation: A LOG READ completed unsuccessfully because 
an error was detected during a Forward READ of the log 
record. This is an internal error. 


| Internal DB2 information = | 


This abend reason code is issued by the following CSECT(s): 
DSNJR103 


[ete Sentin End of Internal DB2 Information _ 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, register 6 contains the address of 
the execution block (EB). All log read cursors reside in a 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5 and described by DSNDLMB. 


00D10342 


Explanation: A LOG READ completed unsuccessfully because 
an error was detected during a Backward READ of a log record. 
This is an internal error. 


[ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJR103 


ee nate End of Internal DB2 Information ee 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVG dump. The execution unit 
then terminates abnormally. 
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Operator Response: Collect the SYS1.L.OGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, register 6 contains the address of 
the execution block (EB). All log read cursors reside ina 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5 and described by DSNDLMB. 


00D10343 


Explanation: A LOG READ completed unsuccessfully because 
an error was detected during a READ of a log record due to an 
invalid Cl offset. This is an internal error. 


| "J. as Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJR103 


te eee eS End of Internal DB2 Information se | 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requesis an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obiain the SYS1.LOGREC and 
the SVC dump. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. in addition, register 6 contains the address of 
the execution biock (EB). All jog read cursors reside ina 
recovery log manager storage pool whose header address is in 
the log manager block (LMB) at LMBRCPHB. The LMB is 
pointed to by register 5 and described by DSNDLMB. 


00D10406 


Explanation: The bootstrap data set access service received a 
request with an invalid function code. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJBO01 


| Ss End of Internal DB2 Information sd 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect ali relevant diagnostic materials, 
including SYS1.LOGREC, SVC dump, and console output. Notify 
the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the foilowing diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 5, 
15. 


00D10410 


Explanation: An unsuccessful completion of a READ BSDS 
RECORD has occurred. An error has been returned from 
VSAM. 


internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNJB002 


Ps a End of Internat DB2 Information eae ee 2) 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Use the SYS1.LOGREC and 
SVC dump to determine the cause of the problem. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, the VSAM RPL fields RPLERRCD and 
RPLERREG are stored in the BSDS request parameter list. The 
address of the BSDS request parameter list is stored in the 
BSDS request element (BSDSRQEL) field (located at offset X'8' 
in the bootstrap data set block). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 15. 


00D10411 


Explanation: An unsuccessful completion of a WRITE UPDATE 
BSDS RECORD has occurred. An error has been returned from 
VSAM. 


Fe Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJB002 


mee eee End of Internal DB2 Information beast co: iy" 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Determine the cause of the problem from the diag- 
nostic information in the Problem Determination section of this 

message. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. in addition, the VSAM RPL fields RPLERRCD and 
RPLERREG are stored in the BSDS request parameter list. The 
address of the BSDS request parameter list is stored in the 
BSDS request element (BSDSRQEL) field (located at offset 8 in 
the bootstrap data set block). 


00D10410 — 00D10413 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 15. 


00D10412 


Explanation: An unsuccessful completion of a WRITE INSERT 
BSDS RECORD has occurred. An error has been returned from 
VSAM. 


— internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJBO002 


er End of internal DB2 Information eit feu 4) 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Collect the SYS1.LOGREC and SVC dump. 
Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Determine the cause of the problem from the diag- 
nostic information in the Problem Determination section of this 

message. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, the VSAM RPL fields RPLERRCD and 
RPLERREG are stored in the BSDS request parameter list. The 
address of the BSDS request parameter list is stored in the 
BSDS request element (BSDSRQEL) field (located at offset 8 in 
the bootstrap data set block). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 15. 


00D10413 


Explanation: An unsuccessful completion of a DELETE BSDS 
RECORD has occurred. An error has been returned from 
VSAM. 


= Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJB002 


ea End of Internal DB2 Information ae 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Determine the cause of the problem from the diag- 
nostic information in the Problem Determination section of this 

message. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, the VSAM RPL fields RPLERRCD and 
RPLERREG are stored in the BSDS request parameter list. The 
address of the BSDS request parameter list is stored in the 
BSDS request element (BSDSRQEL) field (located at offset 8 in 
the bootstrap data set block). 
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00D10500 — 00D10701 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 15. 


00D10500 


Explanation: The recovery log manager’s dynamic allocation 
function has been passed a bad function code (LRB4FUNC in 
control block LRB4). 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJDSO1 


epee re End of Internal DB2 Information ae ee | 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain the SYS1.L.OGREC and 
SVC dump. Determine the cause of the problem from the diag- 
nostic information in the Problem Determination section of this 
message. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, trace entry 501 provides the return 
address to the module that passed the LRB4 with the undefined 
function code. It also provides the address of the LRB4. This 
address is also in register 7 at the time of the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 


00D10501 


Explanation: The recovery log manager’s common access 
method services has been passed a bad function code 
(DSPLFUNC in control block DSPL). 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNJDS05 


ta en: End of internal DB2 Information eee ce Sl 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Determine the cause of the problem from the diag- 
nostic information in the Problem Determination section of this 
message. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. The address of the DSPL is provided in register 
3, and the invalid function in register 4. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 
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00D10700 


Explanation: An error completion code was returned by 
SETLOCK OBTAIN. 


~ internal DB2 information = 


This abend reason code is issued by the following CSECT(s): 
DSNJM002 


ee End of Internal DB2 Information Fe at Sl) 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Determine the cause of the problem from the diag- 
nostic information in the Problem Determination section of this 

message. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 
on page 4-55. In addition, register 0 contains the return code 
from SETLOCK OBTAIN. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 


00D10701 


Explanation: An error completion code was returned by 
SETLOCK RELEASE. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNJM002 


ee End of Internal DB2 Information ered | 


System Action: An execution unit writes a record to 
SYS1.LOGREC and requests an SVC dump. The execution unit 
then terminates abnormally. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain the SYS1.LOGREC and 
SVC dump. Determine the cause of the problem from the diag- 
nostic information in the Problem Determination section of this 
message. 


Problem Determination: RLM standard diagnostic information 
is provided in “Recovery Log Manager Reason Codes (X'D1')” 


‘on page 4-55. In addition, register 0 contains the return code 


from SETLOCK RELEASE. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 


DB2 Codes 4-81 


00D30000 — 00D30004 





Distributed Data Facility Codes (X'D3') 


00D30000 


Explanation: The operator canceled the allied ageni at the 
requesting location and a dump was requested, or the agent 
abended with a reason code that indicated a possible communi- 
cation problem. !n either case, the database access agent at 
this location abended to take a dump to assist in problem deter- 
mination. 


—e — Internal DB2 Information ~~ as 


This abend reason code is issued by the following CSECT(s): 
DSNLABRT 


[is estes End of Internal DB2 Information ee ee 


System Action: The agent terminates. 
Operator Response: Notify the system programmer. 


System Programmer Response: The information collected as a 
result of this abend is related to information collected at the 
requesting location. Obtain a copy of the SYS1.LOGREC listing 
and the SVC dump. Contact the system programmer at the 
requesting location (the location name can be determined from 
the dump header) to coordinate further action. 


Probiem Determination: This abend was initiated in order to 
save diagnostic information that might be useful in problem 
determination. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D30001 


Explanation: The DPS RALE was not initialized. The 
DSNLSPRR was invoked with the DPSB defined as the func- 
tional recovery routine (FRR) anchor. The DPSB is created 
after the DPS RALE is initialized. 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-S5: 
55, 56. 


00D30002 


Explanation: The distributed data facility (DDF) standard 
ESTAE and FRR recovery routines detected a bad recovery 
element. This is a DB2 internal error. 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D30003 


Explanation: While establishing an ESTAE functional recovery, 
DB2 detected a failure. 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D30004 


Explanation: A database access agent received an invalid 
message. This is a DB2 internal error. 


= ~~ _ Internal DB2 Information xs To 


This abend reason code is issued by the following CSECT(s): 


DSNLABRT DSNLPREP DSNLRUSE 
DSNLTMRR 


Wee ee End of Internal DB2 Information fee oe 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


DB2 Codes 4-83 








00D30005 — 00D3000A 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix. B, “Problem Determination” on page X-5: 
55, 56. 


00D30005 


Explanation: DB2 detected a failure while retrying DB2 
recovery. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLFRCV 


bee A End of Internal DB2 Information al 


System Action: DB2 abends after it writes a SYS1.LOGREC 
record and requests a SVC dump. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of the SYS1.LOGREC listing and the SVC dump. 
Determine the failing environment (DB2, IMS/VS, CICS, or TSO), 
and refer to Section 5 of the Diagnosis Guide and Reference for 
failure analysis procedures. 


Problem Determination: A distributed data facility (DDF) 
module retried recovery after an abend, but invalidly returned 
control to the DDF functional recovery routine (DSNLFRCV) that 
issued the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D30008 


Explanation: The distributed transaction manager (DTM) could 
not allocate a RALE for the distributed data facility (DDF). This 
is a DB2 internal error. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLARAL, DSNLTMRA 


L End of Internal DB2 Information So 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


4-84 DB2 Messages and Codes 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D30009 


Explanation: During allocation of a database access agent, 
simultaneous use of an APLE was attempted. An APLE can be 
used once during allocation of a database access agent. This 
is a DB2 internal error. 


[ ~~ jnternal DB2 Information ~ =) 


This abend reason code is issued by the following CSECT(s): 
DSNLTMRA 


Vise ede ee End of Internal DB2 Information Se eS 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3000A 


Explanation: DB2 invoked a function of the distributed trans- 
action manager (DTM). The required function could not be per- 
formed because the DPSB control block does not exist. This is 
a DB2 internal! error. 


= : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNLBABR DSNLCMT1 DSNLCMT2 
DSNLDALB DSNLTMIG 


er End of Internal DB2 Information Sere 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3000B8 


Explanation: A function of the distributed transaction manager 
(DTM) was invoked and attempted to establish a functional 
recovery environment. The functional recovery element (FRE) 
that was created was not the first one on the chain of FREs 
anchored in the DPSB. This is a DB2 internal error. 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLCMT1, DSNLCMT2 


Weree me on. End of Internal DB2 Information ee ad 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3000C 


Explanation: The location name received in a response 
message from a responding site disagrees with the location 
name to which the request message was sent. This is a DB2 
internal error. 


| Internal DB2 Information ~_ ia | 


This abend reason code is issued by the following CSECT(s): 
DSNLCMT1 


[Ss End of internal DB2 Information 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Coilect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3000B — 00D30010 


00DS000E 


Explanation: The DSNLFTMB macro was invoked to determine 
whether an update request was sent to a specified location, but 
the transaction has not yet been migrated to that location. This 
is a DB2 internal error. 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3000F 


Explanation: A DB2 resource manager attempted to add a 
duplicate entry to the list of resource managers. This list con- 
tains the names of resource managers that can participate in 
the allocation of a database access agent at a remote site. This 
is a DB2 internal error. 


et : ~— Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLADRA _ 


Deh End of Internal DB2 Information Soe eats H 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The execution unit abends. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC listing and the SVC dump. Determine the failing 
environment (DB2, IMS/VS, CICS, or TSO), and refer to Section 
5 of the Diagnosis Guide and Reference for failure analysis pro- 
cedures. 


Problem Determination: The module that incorrectly invoked 
this function also invoked DSNLADRA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D30010 


Explanation: A DB2 resource manager attempted to delete a 
resource manager that is not given in the list of resource man- 
agers that participate in the allocation of a database access 
agent at a remote site. This is a DB2 internal error. 


| Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNLADRA 


End of Internal DB2 Information Sf e | 


DB2 Codes 4-85 


00D30011 — 00D30015 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The execution unit abends. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC listing and the SVC dump. Determine the failing 
environment (DB2, IMS/VS, CICS, or TSO), and refer to Section 
5 of the Diagnosis Guide and Reference for failure analysis pro- 
cedures. 


Problem Determination: This module which incorrectly invoked 
this function also invoked DSNLADRA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D30011 


Explanation: Only a certain number of resource managers can 
participate in the allocation of a database access agent at a 
remote site. The maximum has been attained and cannot be 
extended. This is a DB2 internal error. 


| Internal DB2 Information ~ =. 


This abend reason code is issued by the following CSECT(s): 
DSNLADRA 


(ee rt End of Internal DB2 Information eee 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The execution unit abends. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC listing and the SVC dump. Determine the failing 
environment (DB2, IMS/VS, CICS, or TSO), and refer to Section 
5 of the Diagnosis Guide and Reference for failure analysis pro- 
cedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00D30012 


Explanation: More than one resource manager attempted to 
reserve the same RALE for use in the allocation of a database 
access agent at a remote site. This is a DB2 internal error. 


| Internal DB2 Information ——_——————~«;Z 


This abend reason code is issued by the following CSECT(s): 
DSNLTMIG 


——— End of Internal DB2 Information ——— 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The execution unit abends. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC listing and the SVC dump. Determine the failing 
environment (DB2, IMS/VS, CICS, or TSO), and refer to Section 
5 of the Diagnosis Guide and Reference for failure analysis pro- 
cedures. 


Problem Determination: The RALE was previously reserved by 
another resource manager and is not available. 
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Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D30013 


Explanation: The facility section (DSN6FAC) in the DB2 initial- 
ization parameter module does not exist. 


| Internal DB2 Information —- = 


This abend reason code is issued by the following CSECT(s): 
DSNLSSRW 


Me sees End of internal DB2 Information a ees 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The distributed data facility is termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an installa- 
tion error. Obtain a listing of the DSNZPARM module used. 


Probiem Determination: Ensure that DSN6FAC was installed 
correctly, 


00D30014 


Explanation: The distributed transaction manager (DTM) 
detected an internal error. This is a DB2 internal error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCMT1, DSNLPREP 


a End of internal DB2 Information | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D30015 


Explanation: The facility section (DSN6FAC) in the DB2 initial- 
ization parameter module is invalid. 


| ; Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLSSRW 


ee ete End of Internal DB2 Information soe sateen + all 





| 


| [|  End of Internal DB2 Information ______| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The distributed data facility (DDF) is ter- 
minated. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an installa- 
tion error. Obtain a listing of the DSNZPARM module used. 


Problem Determination: Ensure that DSN6FAC was installed 
correctly. 


00D30016 


Explanation: An allied agent received an invalid response. 
This is a DB2 internal error. 


| internal DB2 Information : as 


This abend reason code is issued by the following CSECT(s): 
DSNLCMT1 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D30018 


Explanation: An agent exists at the site at which the abend 
occurred, but an agent that should exist at another site does not 
exist at that site. This is probably a DB2 internal error. 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The execution unit abends. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC listing and the SVC dump. Determine the failing 
environment (DB2, IMS/VS, CICS, or TSO), and refer to Section 
5 of the Diagnosis Guide and Reference for failure analysis pro- 
cedures. 


Problem Determination: The distributed data facility (DDF) 
error monitor, which terminates the agent that is waiting for 
some action to be taken by the nonexistent agent, detects this 
error. The module that was waiting for the action of the nonex- 
istent agent is the module that issued the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D30016 — 00D3001B 


00D30019 


Explanation: The distributed data facility (DDF) error monitor 
detected an error at another site which caused the agent at this 
site to be canceled. This is probably a DB2 internal error. 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. The execution unit abends. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC listing and the SVC dump. Determine the failing 
environment (DB2, IMS/VS, CICS, or TSO), and refer to Section 
5 of the Diagnosis Guide and Reference for failure analysis pro- 
cedures. 


Problem Determination: The DDF error monitor, which termi- 
nates the agent because of an error detected at another site to 
which the agent is connected and for which the agent is waiting, 
detected this error. The module that was suspended to wait for 
the action to be taken at the other site is the module that issued 
the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D3001A 


Explanation: A -CANCEL DDF THREAD command naming a 
distributed agent caused that agent to be terminated. 


System Action: DB2 writes a SYS1.LOGREC record and 
requests an SVC dump. The execution unit abends. If the can- 
celed distributed agent is an allied agent then DB2 requests the 
cancelation of each associated database access agent at each 
of the responding sites (refer to the explanation for 00D30000). 


Operator Response: Notify the system programmer. 


System Programmer Response: The command might have 
been used to terminate an agent that was in a state where no 
processing was occurring and the agent could not continue. If 
an internal DB2 error is suspected, obtain a copy of the 
SYS1.LOGREC listing and the SVC dump. Determine the failing 
environment (DB2, IMS/VS, CICS, or TSO), and refer to Section 
5 of the Diagnosis Guide and Reference for failure analysis pro- 
cedures. 


Problem Determination: The agent terminated because the 
-CANCEL DDF THREAD command had been issued. The 
module that was suspended while waiting for some action to be 
taken is the module that issued the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00D3001B 


Explanation: Database Access Agent allocation failed, 
because the SYSIBM.SYSUSERNAMES table at the responding 
site did not contain a row whose AUTHORIZATION ID column 
matched the primary AUTHORIZATION ID received from the 
requesting DB2 system. When the USERNAMES column in 
SYSIBM.SYSLUNAMES specifies 'I' or 'B', inbound name 
translation is in effect. The SYSIBM.SYSUSERNAMES table 
must contain entries describing the local DB2 AUTHORIZATION 
ID to be used for each primary DB2 AUTHORIZATION ID sent by 
the requesting DB2 system. 


DB2 Codes 4-87 


00D3001C — 00D300F8 


i Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNLTMRA 


[End of internal DB2 Information 


System Action: The reason code is returned to the application. 


User Response: Notify the communications database adminis- 
trator 


Operator Response: Notify the communications database 
administrator 


System Programmer Response: Make sure the USERNAMES 
column in SYSIBM.SYSLUNAMES has been specified correctly 
for the indicated LUNAME. If you intend to use local AUTHORI- 
ZATION IDs that differ from the remote primary AUTHORI- 
ZATION IDs, verify that the SYSIBM.SYSUSERNAMES table has 
rows that correctly specify the local AUTHORIZATION ID to be 
used for each possible remote primary AUTHORIZATION ID. 
These rows must specify '1l' in the TYPE column of the 
SYSIBM.SYSUSERNAMES table. 


Problem Determination: Analyze the SYSIBM.SYSUSERNAMES 
table for an incorrect or missing entry. 


00D3001C 


Explanation: Database Access Agent allocation was not per- 
formed, because the SYSIBM.SYSUSERNAMES table at the 
responding site did not contain a row whose AUTHORIZATION 
ID column matched the NEWUSER primary AUTHORIZAITION ID 
received from the requesting DB2 system. When the 
USERNAMES column in SYSIBM.SYSLUNAMES specifies 'I' or 
'B', inbound name translation is in effect. The 


’ SYSIBM.SYSUSERNAMES table must contain entries describing 


the local DB2 AUTHORIZATION ID to be used for each primary 
AUTHORIZATION ID sent by the requesting DB2 system. 


2 ———~_ internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNLRUSE 


a er End of interna! DB2 Information _ 


System Action: The reason code is returned to the application. 
The database access agent is not allocated. 


User Response: Notify the communications database adminis- 
trator. 


Operator Response: Notify the communications database 
administrator. 


System Programmer Response: Make sure the USERNAMES 
column in SYSIBM.SYSLUNAMES has been specified correctly 
for the indicated LUNAME. If you intend to use local NEWUSER 
AUTHORIZATION IDs that differ from the remote NEWUSER 
primary AUTHORIAZATION IDs, verify that the 
SYSIBM.SYSUSERNAMES table has rows that correctly specify 
the local AUTHORIZATION ID to be used for each possible 
remote primary AUTHORIZATION ID. These rows must specify 
‘!' in the TYPE column of the SYSIBM.SYSUSERNAMES table. 


Problem Determination: Analyze the SYSIBM.SYSUSERNAMES 
table for an incorrect or missing entry. 
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00D3001D 


Explanation: Database Access Agent allocation failed, 
because the SYSIBM.SYSUSERNAMES table at the responding 
site did not contain a row whose AUTHORIZATION ID column 
matched the plan owner's AUTHORIZATION ID received from 
the requesting DB2 system. When the USERNAMES column in 
SYSIBM.SYSLUNAMES specifies 'I' or 'B', inbound name 
translation is in effect. The SYSIBM.SYSUSERNAMES table 
must contain entries describing the local plan owner AUTHORI- 
ZATION ID to be used for each plan owner DB2 AUTHORI- 
ZATION ID sent by the requesting system. 


—e Internal DB2 Information —— ~ | 


This reason code is issued by the following CSECT(s): 
DSNLTMRA 


a End of Internal DB2 Information eee eas 


System Action: The reason code is returned to the application. 


User Response: Notify the communications database adminis- 
trator. 


Operator Response: Notify the communications database 
administrator. 


System Programmer Response: Make sure the USERNAMES 
column in SYSIBM.SYSLUNAMES has been specified correctly 
for the indicated LUNAME. If you intend to use local plan owner 
AUTHORIZATION IDs that differ from the remote plan owner 
AUTHORIZATION IDs, verify that the SYSIBM.SYSUSERNAMES 
table has rows that correctly specify the local AUTHORIZATION 
ID to be used for each possible remote plan owner AUTHORI- 
ZATION ID. These rows must specify '!' in the TYPE column of 
the SYSIBM.SYSUSERNAMES table. 


Problem Determination: Analyze the SYSIBM.SYSUSERNAMES 
table for an incorrect or missing entry. 


00D3001E 


Explanation: The SYSTEM PARAMETER section (DSN6SYSP) in 
the DB2 installation parameter module does not exist. 


[ae internal DB2 Information ~— “| 


This abend reason code is issued by the following CSECT(s): 
DSNLTMIN 


len See End of Internal DB2 Information id 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DDF is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an installa- 
tion error. Obtain a listing of the DSNZPARM module used. 


Problem Determination: Ensure that DSN6SYSP was installed 
correctly. 


O00D300F8 


Explanation: An attempt was made to access data at a remote 
location which has been started in restricted access mode. No 
remote access is allowed. 


r ae Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLAGNT 


Ree seats End of Internal DB2 Information es 


System Action: The attempt to create the data base access 
thread is rejected. 


User Response: Notify the system programmer. 

Operator Response: Notify the system programmer. 

System Programmer Response: Determine the remote location 
where the remote data access was 


attempted. Retry the request when the remote location has 
been restarted in full access mode. 


00D300F9 


Explanation: An attempt was made to access data at a remote 
location which has a limit of '0' database access threads. 


p= — Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLAGNT 


eee eer ane End of Internal DB2 Information etd 


System Action: The attempt to create the database access 
thread is rejected. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the remote location 
where the remote data access was attempted. If this remote 
location is Supposed to allow remote access then check that 
MAXDBAT was specified as a non-zero value when DB2 was 
installed at the remote location. (MAXDBAT is specified as a 
System Parameter.) 


OOD300FA 


Explanation: You attempted a COMMIT statement for a plan 
that specified ISOLATION (RR) and update operations were per- 
formed either at the local site or at a remote site. The COMMIT 
operation could not be performed because the COMMIT request 
could not be transmitted to a remote site where Repeatable 
Read operations had been performed. 


aa Internal DB2 Information 2 c 


This abend reason code is issued by the following CSECT(s): 
DSNLCMT1 


ee eee End of Interna! DB2 Information fee atl 


System Action: All update operations were backed out. 
User Response: Rerun the application. 

Operator Response: None required. 

System Programmer Response: None required. 


Problem Determination: Determine why the COMMIT failed 
and retry the application. 


| 
| 


O0O0D300F9 — OO0D300FE 


00D300FB 


Explanation: A resource was not available during database 
access agent allocation at a remote site. 


[ee ~~ Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNLTMRA 


(edie Rees End of Internal DB2 Information ee Aces 


System Action: The allocation of the database access agent 
was unsuccessful. A ‘resource not available’ code is returned 
to the user. DB2 requests neither a SVC dump nor a 
SYS1.LOGREC record. 


User Response: Notify the system programmer. Invoke the 
application after the problem has been corrected. 


System Programmer Response: Refer to Section 5 of the Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Determine the name of the resource 
being allocated and correct the probiem. 


00D300FC 


Explanation: You attempted to allocate a resource at a remote 
site using an invalid name. 


[ ~ Interna! DB2 Information = | 


This abend reason code is issued by the following CSECT(s): 
DSNLTMRA 


eos End of Internal DB2 Information oe ta 


System Action: The allocation of the database access agent 
was unsuccessful. A 'resource not available' code is returned 
to the user. DB2 requests neither a SVC dump nor a 
SYS1.LOGREC record. 


User Response: Notify the system programmer. invoke the 
application after the problem has been corrected. 


System Programmer Response: Refer to Section 5 of the Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Determine the resource being allo- 
cated and correct the problem. 


00D300FE 


Explanation: You executed a COMMIT statement and update 
operations were performed at a remote site. The success of 
the COMMIT operation could not be determined because a 
failure occurred at the remote site or in the communication link 
with the remote site after the request to commit the operation 
had been transmitted. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCMT1 


Boga a End of Internal DB2 Information Sage 


System Action: The remote updates have been committed or 
backed out, depending on when the error occurred. 


DB2 Codes 4-89 


OOD300FF — 00D31013 


User Response: After communication has been reestablished 
with the remote site, use SQL to query the updated data to 
determine whether the updates had been committed. If the 
updates were not updated, rerun the application and perform 
the updates again. 


O0OD300FF 


Explanation: You attempted a COMMIT statement and update 
operations were performed at a remote site. The attempt 
failed. 


7 = =. Internal DB2 Information =. = 


This abend reason code is issued by the following CSECT(s): 
DSNLCMT1 


Lo End of Internal DB2 Information ee | 


System Action: The updates at the remote site have been 
backed out. 


User Response: Rerun the application. 


Problem Determination: Determine why the COMMIT failed 
and retry the application. 


00D31010 


Explanation: An internal logic error occurred while a DCRM 
functional service was being invoked. 


| = Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNLCCCN DSNLCSRM DSNLCTCN 
DSNLCBCS DSNIINI DSNIIN1 
DSNIIN2 DSNLCSBC DSNLCLCN 
DSNLCQDG DSNLCSIM DSNLITRM 
DSNLCTRM DSNLCTRC 


[| End of Internal DB2 Information i 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31011 


Explanation: An internal logic error occurred while invoking a 
VTAM functional service. 


4-90 DB2 Messages and Codes 


| internal DB2 Information ~ a 


This abend reason code is issued by the following CSECT(s): 
DSNLVnnn 


"DSNLVnnn' is the full CSECT name given in the dump title. 
er End of Internal DB2 Information eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 


Operator Response: Collect the SYS1.LOGREC listing and the 
SVC dump. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNLO27 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31012 


Explanation: A VTAM functional service request failed because 
the state of the conversation was invalid for the request. 


[= ~~ Internal DB2 Information ~ => iil 


This abend reason code is issued by the following CSECT(s): 
DSNLVFSM 


————- End of Internal DB2 Information age eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 


Operator Response: Collect the SYS1.LOGREC listing and the 
SVC dump. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31013 


Explanation: A DB2 message was received with an invalid 
message block header (MBH). The MBH is a header that pre- 
cedes all messages exchanged between two DB2 subsystems. 


f -— Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLVPF5 


[Beret End of Internal DB2 Information 3 eel 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 


Operator Response: Collect the SYS1.LOGREC listing and the 
SVC dump. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31014 


Explanation: One or more invalid parameters were supplied 
while invoking a VTAM functional service. 


aa ~~ Internal DB2 Information ~———_————— | 


This abend reason code is issued by the following CSECT(s): 


DSNLVAAC DSNLVCNS DSNLVSCA 
DSNLVDDC DSNLVSEA DSNLVRCA 
DSNLVSDA 


————— End of Internal DB2 Information pee ees 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 


Operator Response: Collect the SYS1.LOGREC listing and the 
SVC dump. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31014 — 00D31025 


00D31022 


Explanation: The requested VTAM function for allocating a 
conversation was not performed because the data manager 
returned an unavailable resource when attempting to read the 
SYSIBM.SYSLOCATIONS table in the communication database 
(CDB). The LOCATION cannot be resolved to the remote DB2 
subsystem LUNAME. 


| = ia . Internal DB2 Information ~— — a1 


This abend reason code is issued by the following CSECT(s): 
DSNLVCDB 


——— End of internal DB2 Information es 


System Action: Notification of the failure is returned to the 
application. The conversation is not allocated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of the Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: For more information, refer to the 
explanation of message DSNL700! on page 3-104. Collect the 
following diagnostic items: 


© Definitions of the communication database (CDB) table 
space, tables, and indexes involved in the error. 


e \tems 1 and 5 listed in Appendix B, “Problem 
Determination” on page X-5. 


00D31024 


Explanation: The requested VTAM function for allocating a 
conversation was not performed because the location name is 
not defined in the SYSIBM.SYSLOCATIONS table in the commu- 
nication database (CDB). 


; Internal DB2 Information . | 


This abend reason code is issued by the following CSECT(s): 
DSNLVCDB 


Pes End of Internal DB2 Information ser ens 


System Action: Notification of the failure is returned to the 
application. The conversation is not allocated to the specified 
location. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Add the location to the 
SYSIBM.SYSLOCATIONS table. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
72, 73. 


00D31025 


Explanation: The requested VTAM function for allocating a 
conversation was not performed because a mode name could 
not be found in the SYSIBM.SYSMODESELECT table in the com- 
munication database (CDB) for the requesting thread. 


DB2 Codes 4-91 


00D31026 — 00D31032 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLVCDB 


fs ash <3 End of internal DB2 Information fae nd 


System Action: Notification of the failure is returned to the 
application. The conversation is not allocated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Add the mode name to be 
selected in the SYSIBM.SYSMODESELECT table for the 
AUTHORIZATTION ID, PLANNAME, and LUNAME of the service 
request that failed. 


Probiem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
74, 75. 


00D31026 


Explanation: The requested VTAM function was not performed 
because VTAM returned a non-zero return code while 
attempting to communicate on a conversation. 


— i. ig Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLVRPL 


{oo End of Internal DB2 Information _ 


System Action: Notification of the failure is returned to the 
application. The conversation is abnormally deallocated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of the Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: For more information, refer to the 
explanation of message DSNL500I on page 3-102, or message 
DSNL502I 3-103, depending on the type of conversation that 
failed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 


00D31027 


Explanation: The requested VTAM function cannot be per- 
formed because VTAM is abending or because the operator has 
issued a HALT NET command to terminate VTAM. 


| Internal DB2 Information ——— ay 7 


This abend reason code is issued by the following CSECT(s): 


DSNLVAAC DSNLVCNS DSNLVDDC 
DSNLVRCA DSNLVSCA DSNLVSDA 
DSNLVSEA 


Se eee End of Internal DB2 Information eee sl 
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System Action: Notification of DDF termination is reported to 
the application. No remote communications are allowed. The 
distributed data facility is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine why VTAM was ter- 
minated. 


00D31029 


Explanation: The requested VTAM function to allocate a con- 
versation failed. VTAM returned a non-zero return code while 
attempting to negotiate limits with a remote location for a mode. 


| ~~~ Internal DB2 Information a 


This abend reason code is issued by the following CSECT(s): 
DSNLVRPL 


[ec ot, aed End of internal DB2 Information id 


System Action: Notification of the failure is returned to the 
application. All communications to the remote location on the 
mode fail until the CNOS is successfully negotiated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of the Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: For more information, refer to the 
explanation of message DSNL5011 on page 3-103. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00D31031 


Explanation: The local distributed data facility (DDF) is termi- 
nating. 


| Internal DB2 Information = se ey 


This. reason code is issued by the following CSECT(s): 
DSNLCCCN 


{oo End of Internal DB2 Information _ 


System Action: Notification of the failure is returned to the 
application. DB2 does not allow any new distributed threads 
while DDF is in termination or is terminated. 


User Response: Contact your system programmer to deter- 
mine why DDF was terminated. 


Operator Response: Contact the system to determine the 
cause of DDF termination. 


System Programmer Response: To determine why DDF was 
terminated and then start DDF. 


00D31032 


Explanation: The requested VTAM function failed because the 
distributed data facility (DDF) at the remote location is termi- 
nating. 


[ a internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLVRPL 


| snd of internat DB2 Information ____——_— 


System Action: DB2 writes a SYS1.LOGREC record. No com- 
munication on the conversation is allowed. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: To determine the cause of the 
DDF termination, contact the communication administrator at 
the location. 


00D31033 


Explanation: The VTAM function request to allocate a conver- 
sation failed because the thread timed-out while waiting for a 
session. 


f- eo Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLVAAC 


[| End of Internal DB2 Information 


System Action: Notification of the failure is returned to the 
application. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: The defined session limit for 
the mode used by the thread might be too small. The 
CONVLIMIT specified for the mode might have to be negotiated 
with the communication administrator at the remote subsystem. 


Problem Determination: Refer to message DSNL510I for the 
limit negotiated by VTAM for the location and mode used by the 
thread. Collect the following diagnostic items listed in 
Appendix. B, “Problem Determination” on page X-5: 1, 5, 76. 


00D31035 


Explanation: The requested VTAM function failed. The data- 
base access agent was aborted at the remote location. Notifi- 
cation of the failure is returned to the application. This is an 
internal error. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLCTRC 


[esis tet ae End of Internal DB2 Information bere tee 


System Action: DB2 writes a SYS1.LOGREC record and 
requests an SVC dump.at the failed DB2 site. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Obtain copies of the 
SYS1.LOGREC and SYSLOG data sets from each connected 
site, the SVC dump at the site of the DB2 failure, and any 


00D31033 — 00D31037 


_ related dumps from each connected site. Refer to Section 5 of 


the Diagnosis Guide and Reference for failure analysis proce- 
dures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31036 


Explanation: The LINKNAME column of the 
SYSIBM.SYSLOCATIONS table was invalid. Since LINKNAME is 
a foreign key of the SYSIBM.SYSLUNAMES table, the 
LINKNAME column must specify one of the values provided in 
the LUNAME column of the SYSIBM.SYSLUNAMES table. This 
error should not occur. 


| Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNLVCLM 


re End of Internal DB2 Information ae ees 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 


Operator Response: Coliect the SYS1.LOGREC, and the SVC 
dump. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31037 


Explanation: The request was not migrated to the remote site, 
because the SYSIBM.SYSUSERNAMES table did not contain an 
outbound row, the TYPE column specified as an 'O', describing 
the remote authorization identifier to be used for this primary 
AUTHORIZATION ID. When the USERNAMES column in 
SYSIBM.SYSLUNAMES specifies 'O' or 'B' requiring outbound 
name translation, the SYSIBM.SYSUSERNAMES table must 
contain entries describing the remote authorization ID to be 
used for each primary AUTHORIZATION ID communicating with 
that LUNAME. 


— Internal DB2 Information 7 


This reason code is issued by the following CSECT(s): 
DSNLCCCN 


[me eee eee End of Internal DB2 Information a eee 


System Action: The reason code is returned to the application. 
The database access agent is not allocated. 


User Response: Notify the communications database adminis- 
trator. 


DB2 Codes 4-93 


00D31038 — 00D3103D 


Operator Response: Notify the communications database 
administrator. 


System Programmer Response: Make sure the USERNAMES 
column in SYSIBM.SYSLUNAMES has been specified correctly 
for the indicated LUNAME. If you intend to use remote primary 
authorization ID that differ from the DB2 AUTHORIZATION ID, 
verify that the SYSIBM.SYSUSERNAMES table has rows that 
correctly specify the remote primary authorization ID to be used 
for each possible primary DB2 AUTHORIZATION ID. 


Problem Determination: Analyze the SYSIBM.SYSUSERNAMES 
table for an incorrect or missing entry. 


00D31038 


Explanation: The requested VTAM function to allocate a con- 
versation was not performed because the LOCATION name pro- 
vided by the remote DB2 system is already associated with 
another DB2 subsystem. 


ce ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLVCDB 


as End of Internal DB2 Information pena te 


System Action: A record is written to SYS1.LOGREC and the 
conversation is not allocated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Make sure each remote DB2 
system has a unique LOCATION name and a unique LUNAME. 
The SYSIBM.SYSLOCATIONS table must correctly associate 
these LOCATION names with their corresponding LUNAME 
names. 


Problem Determination: 


® Determine the LUNAME and LOCATION name of the DB2 
system that attempted to start a VTAM conversation. 


* Print the contents of the SYSIBM.SYSLOCATIONS table. 


e Issue the -DISPLAY LOCATION command to determine 
which. LUNAMEs and LOCATIONSs were active at the time of 
failure. 


00D31039 


Explanation: The requested VTAM function to allocate a con- 
versation was not performed because the 
SYSIBM.SYSUSERNAMES table at the requesting site did not 
contain a row describing the remote authorization ID to be used 
for this DB2 AUTHORIZATION ID. When the USERNAMES 
column in SYSIBM.SYSLUNAMES specifies 'O' or 'B', out- 
bound name translation is in effect. The 
SYSIBM.SYSUSERNAMES table must contain entries describing 
the remote authorization ID to be used for each DB2 AUTHORI- 
ZATION ID communicating with that LUNAME. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLVCLM 


aeerrensone End of Internal DB2 Information ooh ae 
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System Action: A record is written to SYS1.LOGREC, and the 
conversation is not allocated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Make sure the USERNAMES 
column in SYSIBM.SYSLUNAMES has been specified correctly 
for the indicated LUNAME. If you intend to use remote authori- 
zation IDs that differ from the DB2 AUTHORIZATION ID, verify 
that the SYSIBM.SYSUSERNAMES table has rows that correctly 
specify the remote authorization ID to be used for each possible 
DB2 AUTHORIZATION ID. These rows must specify 'O'in the 
TYPE column of the SYSIBM.SYSUSERNAMES table. 


Problem Determination: Determine the LUNAME and AUTHOR- 
IZATION ID for the failing VTAM conversation. Collect the fol- 
lowing diagnostic items listed in Appendix B, “Problem 
Determination” on page X-5: 57, 58. 


00D3103A 


Explanation: Database Access Agent allocation failed because 
the RACROUTE REQUEST =EXTRACT macro failed to locate a 
user profile for the DB2 primary AUTHORIZATION ID obtained 
from the SYSIBM.SYSUSERNAMES table. When the 
ENCRYPTPSWDS column in SYSIBM.SYSLUNAMES specifies 
'Y', the requesting DB2 system must be able to extract the 
encrypted password (via RACROUTE REQUEST = EXTRACT) 
and send this encrypted password to the responding DB2 
system for validation. 


| Internal DB2 Information ~~ _ Se 


This reason code is issued by the following CSECT(s): 
DSNLVRXT 


Roses End of interna! DB2 Information Set ens 


System Action: The reason code is returned to the application. 


User Response: Notify the communications database adminis- 
trator. 


Operator Response: Notify the communications database 
administrator. 


System Programmer Response: Make sure the new authori- 
zation ID column in SYSIBM.SYSUSERNAMES has been speci- 
fied correctly for the indicated LUNAME. If you intend to use 
encrypted passwords, the new authorization ID must be defined 
to your MVS security subsystem. 


Problem Determination: 


¢ Analyze the SYSIBM.SYSUSERNAMES table for an incorrect 
or missing entry. 

¢ Verify that the names given in the NEWAUTHORIZATION ID 
column are defined to your MVS security subsystem prop- 
erly. 


00D3103D 


Explanation: An attempt to allocate a VTAM LU6.2 conversa- 
tion with a remote subsystem failed because the request did not 
contain the proper security information. This can occur for any 
of the following reasons: 


1. The VTAM APPL definition for the remote DB2 subsystem 
specifies SECACPT = NONE, which is the default for the 
VTAM APPL definition. When this occurs, VTAM will 
remove any AUTHORIZATION ID and PASSWORD fields 








found in the LU6.2 ALLOCATE request, before presenting 
this information to the remote DB2 system. 


2. The remote subsystem requires an AUTHORIZATION ID and 
PASSWORD on the LU6.2 ALLOCATE request, and the focal 
DB2 system did not send this information. 


The local DB2 system examines the USERNAMES column of 
the SYSIBM.SYSLUNAMES table in order to determine 
whether an AUTHORIZATION ID and PASSWORD must be 
sent on the LU6.2 ALLOCATE request. DB2 will send an 
AUTHORIZATION ID and PASSWORD on the LU6.2 ALLO- 
CATE request when the USERNAMES column of the 
SYSIBM.SYSLUNAMES table specifies either 'B' or 'O'. 


The remote DB2 LOCATION will examine the 
USERSECURITY column of the SYSIBM.SYSLUNAMES table 
in order to determine whether an AUTHORIZATION ID and 
PASSWORD must be provided on incoming LU6.2 ALLO- 
CATE requests. If USERSECURITY is set to 'C', DB2 will 
reject incoming LU6.2 ALLOCATE requests that do not 
contain an AUTHORIZATION ID and PASSWORD. 


3. The local DB2 system sent an AUTHORIZATION ID and 
PASSWORD to the remote database subsystem, but either 
the AUTHORIZATION ID or PASSWORD is not valid. This 
can occur for any of the following reasons: 


a. The AUTHORIZATION ID sent to the remote database 
subsystem is not defined to the security subsystem at 
the remote location. 


b. The PASSWORD sent to the remote database sub- 
system did not match the password at the remote 
location. 


c. The ENCRYPTPSWDS column of the 
SYSIBM.SYSLUNAMES table at the local DB2 system 
did not agree with the ENCRYPTPSWDS column of the 
SYSIBM.SYSLUNAMES table at the remote DB2 system. 
This error would cause the remote DB2 system to incor- 
rectly specify the ENCRYPT keyword on the RACROUTE 
REQUEST =VERIFY macro, resulting in a password mis- 
match. 


| 7 ~~ Internal DB2 Information ~~ Seer 


This abend reason code is issued by the following CSECT(s): 
DSNLVRPL 


Vise ees End of Internal DB2 Information deena 


System Action: The attempt to access the remote database 
resource fails and the failure is reported to the application. 


User Response: Notify the communications database adminis- 
trator. 


System Programmer Response: Verify each of the following: 


¢ The USERNAMES column of the SYSIBM.SYSLUNAMES 
table at the local DB2 system must specify either 'O' or 
‘'B', if you intend AUTHORIZATION IDs and PASSWORDs to 
be sent on LU6.2 ALLOCATE requests to the remote DB2 
system. 


¢ The USERSECURITY column of the SYSIBM.SYSLUNAMES 
table at the remote DB2 system is specified correctly. 


* The AUTHORIZATION ID and PASSWORD sent on the LU6.2 
ALLOCATE request are specified correctly in the 
SYSIBM.SYSUSERNAMES table. 


The AUTHORIZATION ID sent to the remote DB2 system is 
taken from the NEW AUTHORIZATION ID column of the 
SYSIBM.SYSUSERNAMES table. 


00D31040 — 00D31041 


if password encryption is used (ENCRYPTPSWDS= 'Y' in 
the SYSIBM.SYSLUNAMES table), the password for the NEW 
AUTHORIZATION ID extracted from the loca! security sub- 
system. If password encryption is not used, the password 
will be taken from the PASSWORD column of the 
SYSIBM.SYSUSERNAMES table. 


* The ENCRYPTPSWDS column of the SYSIBM.SYSLUNAMES 
table must be correctly set at both the local and remote DB2 
systems. 


¢ The AUTHORIZATION ID and PASSWORD sent to the remote 
DB2 system must be defined to the MVS security subsystem 
at the remote system. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
57, 58, 1. 


00D31040 


Explanation: The requested VTAM function failed before the 
database access agent could be determined. This is an internal 
error. 


[ ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCTRC 


Ueto Po End of Internal DB2 Information se ASS ten] 


System Action: DB2 writes a SYS1.LOGREC record and 
requests an SVC dump at the failed DB2 site. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Obtain copies of the 
SYS1.LOGREC and SYSLOG data sets from each connected 
site, the SVC dump at the site of the DB2 failure, and any 
related dumps from each connected site. Refer to Section 5 of 
the Diagnosis Guide and Reference for faiture analysis proce- 
dures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31041 


Explanation: The requested VTAM function to allocate a con- 
versation was not performed because the 
SYSIBM.SYSUSERNAMES table at the responding site did not 
contain a row whose AUTHORIZATION ID column matches the 
DB2 AUTHORIZATION ID the received from requesting DB2 
system. When the USERNAMES column in 
SYSIBM.SYSLUNAMES specifies '1' or 'B', inbound name 
transiation is in effect. The SYSIBM.SYSUSERNAMES table 
must contain entries describing the local DB2 AUTHORIZATION 
ID to be used for each DB2 AUTHORIZATION ID sent by the 
requesting DB2 system. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLVCLM 


bee a ee End of internal DB2 Information eet Seen 


DB2 Codes 4-95 








00D31042 — 00D31101 


System Action: A record is written to SYS1.L.OGREC and the 
conversation is not allocated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Make sure the USERNAMES 
column in SYSIBM.SYSLUNAMES has been specified correctly 
for the indicated LUNAME. if you intend to use local AUTHORI- 
ZATION IDs that differ from the remote DB2 AUTHORIZATION 
ID, verify that the SYSIBM.SYSUSERNAMES table has rows that 
correctly specify the local AUTHORIZATION ID to be used for 
each possible remote AUTHORIZATION ID. These rows must 
specify '|' in the TYPE column of the SYSIBM.SYSUSERNAMES 
table. 


Problem Determination: Determine the LUNAME and AUTHOR- 
IZATION ID for the failing VTAM conversation. Collect the fol- 
lowing diagnostic items listed in Appendix B, “Problem 
Determination” on page X-5: 57. 


00D31042 


Explanation: The requested VTAM function failed. The con- 
nection to the remote location was interrupted. This is an 
internai error. 


Internal DB2 Information = > | 


This abend reason code is issued by the following CSECT(s): 
DSNLCSIM 


[| End of Internal DB2 Information _________| 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the failed DB2 site. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Obtain copies of the 
SYS1.LOGREC and SYSLOG data sets from each connected 
site, the SVC dump at the site of the DB2 failure, and any 
related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31043 


Explanation: The requested VTAM function failed. The con- 
nection from the remote location was interrupted. This is an 
internal error. 


| Internal DB2 Information ~— | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRIM 


Uh toe me: End of Internal DB2 Information a ee] 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the failed DB2 site. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. 
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System Programmer Response: Obtain copies of the 
SYS1.LOGREC and SYSLOG data sets from each connected 
site, the SVC dump at the site of the DB2 failure, and any 
related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination”.on page X-5: 
55, 56. 


00D31100 


Explanation: The data communications conversation manager 
(DCCM) was invoked with a parameter list that contained one or 
more invalid parameters. This is an internal error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNLCCCN DSNLCSRM DSNLCTCN 
DSNLCBCS 


erie Se End of Internal DB2 Information ee ee 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


_ Refer to Section 3 and 4 of the Diagnosis Guide and Reierence 


for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31101 


Explanation: The data communications conversation manager 
(DCCM) was invoked with the cursor table marked invalid. This 
is an internal error. 


| 7 ~~~ Internal DB2 Information ~——————S camry 


This abend reason code is issued by the following CSECT(s): 
DSNLCCCN, DSNLCSRM 


ae: End of Internal DB2 Information _ 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 





sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31102 


Explanation: The data communications conversation manager 
(DCCM) encountered an inconsistency in the requesting thread 
control block structure. This is an internal error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCCCN DSNLCSRM DSNLCTCN 


ere End of Internal DB2 Information ie win | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNLO028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31103 


Explanation: The data communications conversation manager 
(DCCM) received an invalid logical-unit-of-work ID (LUWID) or 
no LUWID. This is an internal error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCCCN 


ae End of Internal DB2 Information Sea 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


00D31102 — 00D31105 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31104 


Explanation: The data communications conversation manager 
(DCCM) cannot find a distributed processing block for the 
primary thread. This is an internal error. 


| Internal DB2 Information = ~ 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM DSNLCTCN DSNLCBCS 


{ End of Internal DB2 Information eae 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31105 


Explanation: The data communications conversation manager 
(DCCM) detected an invalid or incorrect buffer size on a send 
message operation. This is an internal error. 


[~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM 


es End of internal DB2 Information eee 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 
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00D31106 — 00D3110A 


00D31106 


Explanation: The data communications conversation manager 
(DCCM) detected an invalid message sequence. One or more 
rows of data might have been lost. This is an internal error. 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM. 


eee End of Internal DB2 Information ee | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31107 


Explanation: The data communications conversation manager 
(DCCM) was invoked incorrectly (protocol violation) to wait for a 
message. This is an internal error. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM 


ees End of Internal DB2 Information Spee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31108 


Explanation: The data communications conversation manager 
(DCCM) was invoked incorrectly (protocol violation) to receive a 
message. This is an internal error. 
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aa Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM 


aes End of Internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


_User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL0O27 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-S5: 
55, 56. 


00D31109 


Explanation: The data communications conversation manager 
(DCCM) was invoked incorrectly (protocol violation) to send a 
message. This is an internal error. 


| —_—— *- Internal DB2 Information : 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM 


ae End of Internal DB2 Information eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG consoie messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guidé and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3110A 


Explanation: The data communications conversation manager 
(DCCM) detected an invalid message sequence. One or more 
rows of data might have been lost. This is an internal error. 


Internal DB2 Information Sa 8 tee | 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM, DSNLCBCS 


eee ae End of internal DB2 Information Seo | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3110B 


Explanation: While a message was being sent or received, an 
error was detected in DB2. Register 4 contains a reason code 
that provides additional information about this error. This is an 
internal error. 


oo Se ar Internal DB2 Information ~ ea ‘| 


This abend reason code is issued by the following CSECT(s): 
DSNLCSRM, DSNLCSBC 


eee End of Internal DB2 Information cose ees 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31110 


Explanation: Instrumentation facility component (IFC) has 
passed a non-zero return code to DCCM. This is an internal 
error. 


00D3110B — 00D31112 


[~ Poy ee Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


ees End of Internal DB2 Information oo | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31111 


Explanation: The instrumentation facility component (IFC) 
passed a non-zero return code to the data communications con- 
versation manager (DCCM). This is an interna! error. 


internal DB2 information =~" | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


ret End of Internal DB2 Information eas toe oe 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31112 


Explanation: DCCM can not find the LUWID for the requesting 
thread in the database thread control blocks. This is an 
internal error. 


DB2 Codes 4-99 





00D31113 — 00D31116 


| Internal DB2 Information Guat = 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


Cask. Bete End of Internal DB2 Information ees 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-S5: 
55, 56. 


00031113 


Explanation: The data communications conversation manager 
(DCCM) received an invalid set of contro! block pointers. This 
is an internal error. 


Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


| snd of Internal DB2 Information 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31114 


Explanation: A data communications conversation manager 
(DCCM) block for a deallocated conversation that belongs to the 
database thread cannot be found. This is an internal error. 
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i... ~ Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


ee pee See End of Internal DB2 Information ae 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31115 


Explanation: An attempt to enqueue a request for a database 
thread failed. This is an internal error. 


[~ as Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


Deore ete et End of Internal DB2 information eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31116 


Explanation: The data communications conversation manager 
(DCCM) received an invalid DC message number. This is an 
internal error. 


- sae Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


eee eee End of Internal DB2 Information Soe 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNLO027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00031117 


Explanation: The data communications conversation manager 
(DCCM) received a request with an invalid response type. This 
is an internal error. 


Sao ” Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


Ve sine eens End of Internal DB2 Information Baers 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D31118 


Explanation: A message-processing routine returned to the 
data communications conversation manager (DCCM) without 
the requested response. This is an internal error. 





00D31117 — 00D3111A 


| Internal DB2 information Tae q 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


eee ae End of Internal DB2 Information ata ot 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00031119 


Explanation: The data communications conversation manager 
(DCCM) processed a request with an unassigned or discon- 
nected message ciass. This is an internal error. 


ices — Internal DB2 Information a | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


[eee End of internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


OOD3T11A 


Explanation: The data communications conversation (DCCM) 
detected a communications error. This is an internal error. 


DB2 Codes 4-101 





00D3111B — 00D34404 


eee ~_ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCRTR 


eee tee End of Internal DB2 Information ae eel 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNLO28 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3111B 


Explanation: DCCM cannot find the LOCATION for the 
requesting thread in the DCCM control blocks. This is an 
internal error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLCSIM 


a Y End of Internal DB2 Information fee te 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34401 


Explanation: The relational data system (RDS) passed an 
invalid function code to the distributed RDS (DRDS). This is an 
internal error. 


4-102 DB2 Messages and Codes 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXRDS 


a nee et End of Internal DB2 Information ees 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Coliect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34402 


Explanation: The relational data system (RDS) has requested 
distributed RDS (DRDS) services against a section (SLTE) that 
is not recognized as a candidate for distributed access. 


| Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXRDS 


Ue sets End of Internal DB2 Information ieee eee? 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34404 


Explanation: The relational data system (RDS) passed the dis- 
tributed RDS (DRDS) an invalid distributed interface block (DIB). 
This is an internal RDS error. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXRDS 


eae End of Internal DB2 Information ye 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL0O28 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34405 


Explanation: The data communications resource manager 
(DCRM) passed an invalid LMPP message number to the dis- 
tributed relational data system (DRDS). This is either an 
internal DCRM error or an internal DRDS error. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLXRTR 


Nees Seot ees End of Internal DB2 Information eee | 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34406 


Explanation: The distributed relational data system (DRDS) 
detected a message of invalid length from the data communi- 
cations resource manager (DCRM). The message is longer 
than the buffer size. This is either an internal DRDS error or an 
internal DCRM error. 


00D34405 — 00D34408 


[— Yeas Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQPR DSNLXSQD 


eevee ar End of Internal DB2 Information a 


System Action: A record is written to SYS1.L.OGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Probiem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34407 


Explanation: The distributed relational data system (DRDS) 
received an invalid return code from the data communications 
resource manager (DCRM) on a SEND request. This is a DCRM 
internal error. 


| a ” Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQPR DSNLXQFH 


eae es End of internal DB2 Information feat 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNLO28 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34408 


Explanation: The distributed relational data system (DRDS) 
received an invalid LMPP from the data communications 
resource manager (DCRM). This is either a DCRM internal 
error or a DRDS internal error. 


DB2 Codes 4-103 











00D34409 — 00D3440D 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNLXOPF DSNLXPCL DSNLXRTR 
DSNLXPPR DSNLXPXI 


er End of Internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34409 


Explanation: The distributed relational data system (DRDS) 
detected an internal inconsistency. An invalid state transition 
occurred. This is a DRDS internal error. 


| = Internal DB2 Information Pag =i 


This abend reason code is issued by the following CSECT(s): 
DSNLXOPF DSNLXQFH DSNLXRTR 


{ End of Internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3440B 


Explanation: The distributed relational data system (DRDS) 
detected an inconsistency. This is an internal error. 


4-104 DB2 Messages and Codes 


| ~ Internal DB2 Information ae cae 


This abend reason code is issued by the following CSECT(s): 


DSNLXIVB DSNLXRTR DSNLXPPR 
DSNLXPEX DSNLXPXI DSNLXQAL 
DSNLXQPR DSNLXQOP DSNLXQFH 
DSNLXQCL DSNLXCNV DSNLXQXI 
DSNLXQR DSNLXQUR 


[| seEnd of Internal DB2 Information _______———_— 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3440C 


Explanation: The distributed relational data system (DRDS) 
requesting site control block must exist at this time but does 
not. This is an internal DRDS error. 


‘os — Internat DB2 Information ~~ 


This abend reason code is issued by the following CSECT(s): 
DXNLXRDS 


a End of internal DB2 Information Sega tel 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed inAppendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3440D 


Explanation: The distributed statistics and accounting control 
block does not exist. This is an internal distributed data facility 
(DDF) error. 


c Pras Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNLXQGT DSNLXQPR DSNLXPGT 
DSNLXPPR 


——aa End of Internal DB2 Information es 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3440E 


Explanation: A distributed request was received, but the dis- 
tributed data facility (DDF) is inactive. 


[ ~~ Internal DB2 Information oo , | 


This abend reason code is issued by the following CSECT(s): 
DSNLXRDS 


es ioe et End of Internal DB2 Information ee 


System Action: The request is not processed. 
User Response: Notify the system operator. 


Operator Response: Ensure that the DDF has been started. 


00D3440F 


Explanation: The distributed relational data system (DRDS) 
detected a message of invalid length from the data communi- 
cations resource manager (DCRM). The message is smaller 
than the buffer size, but the return code from the DCRM indi- 
cates that the message is greater than one buffer. This is 
either an internal DRDS error or an internal DCRM error. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLXQPR DSNLXSQD 


ee eee End of Internal DB2 Information geen tal 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. 


00D3440E — 00D34411 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34410 


Explanation: The distributed relational data system (DRDS) 
received an invalid return code from the data communications 
resource manager (DCRM) on a RECEIVE request. This is an 
internal DCRM error. 


[oe “— Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQPR DSNLXQFH 


ee End of Internal DB2 Information _ sd 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNLO27 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34411 


Explanation: The distributed relational data system (DRDS) 
detected an internal inconsistency. An invalid state is speci- 
fied. This is an internal DRDS error. 


| Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQFH DSNLXRTR DSNLXOPF 


a End of Internal DB2 Information Span sdk eal 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNLO28 SYSLOG console messages at the site of the DB2 


DB2 Codes 4-105 


00D34412 — 00D34415 


abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34412 


Explanation: The distributed relational data system (DRDS) 
detected an internal inconsistency. An internal buffer offset 
variable contains an invalid value. This is an internal DRDS 
error. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQGT 


ee End of Internal DB2 Information et a 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNLO27 
and DSNL.028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34413 


Explanation: The data header on the message contains invalid 
information. This is an internal error. 


,— — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQGT DSNLXQFH 


Dee ee, End of Internal DB2 Information Seti ae 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


4-106 DB2 Messages and Codes 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Probiem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34414 


Explanation: The relational data system (RDS) did not specify 
an area for the null indicator of the data. This is an internal 
error. 


[ — Internal DB2 Information ~ ~ 7 | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQGT 


Petre End of Internal DB2 Information sini artes. | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34415 


Explanation: The data format specified in the RDI is not valid. 
This is an internal error. 


| Internal DB2 Information ~ a rz ” 


This abend reason code is issued by the following CSECT(s): 
DSNLXIVB 


Dees End of Internal DB2 Information eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34416 


Explanation: An incomplete response was received on a con- 
versation when a complete response was expected. 


[~ PS a es internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQFH 


tte tS End of Internal DB2 Information ee ee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34417 


Explanation: DRDS detected an illegal attempt to enter Contin- 
uous Block Fetch mode. 


fo ~~~ Internal DB2 Information ~ 


This abend reason code is issued by the following CSECT(s): 
DSNLXQFH 


We tates Fe End of Internal DB2 Information ee | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNLO28 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D34416 — 00D34419 


00D34418 


Explanation: The request was not migrated to the remote site 
because the SYSIBM.SYSUSERNAMES table did not contain an 
outbound row, the TYPE column specified as an 'O', describing 
the remote authorization identifier to be used for this plan 
owner AUTHORIZATION ID. When the USERNAMES coiumn in 
SYSIBM.SYSLUNAMES specifies 'O' or 'B' requiring outbound 
name translation, the SYSIBM.SYSUSERNAMES table must 
contain entries describing the remote authorization ID to be 
used for each plan owner AUTHORIZATION ID communicating 
with that LUNAME. 


[ = Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNLXQAL 


eee a End of internal DB2 Information ee 


System Action: The reason code is returned to the application. 
The database access agent is not allocated. 


User Response: Notify the communications database adminis- 
trator. 


Operator Response: Notify the communications database 
administrator. 


System Programmer Response: Make sure the USERNAMES 
column in SYSIBM.SYSLUNAMES has been specified correctly 
for the indicated LUNAME. If you intend to use remote plan 
owner authorization IDs that differ from the local plan owner 
authorization ids, verify that the SYSIBM.SYSUSERNAMES table 
has rows that correctly specify the remote primary authori- 
zation ID to be used for each possible primary DB2 AUTHORI- 
ZATION ID. 


Problem Determination: Analyze the SYSIBM.SYSUSERNAMES 
table for an incorrect or missing entry. 


00D34419 


Explanation: RDS has passed an invalid DESCRIBE request to 
DRDS. This is an internal error. 


Interna! DB2 Information ~~ ‘fl 


This abend reason code is issued by the following CSECT(s): 
DSNLXRDS 


ee seers End of Internal DB2 Information eee || 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.L.OGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


DB2 Codes 4-107 





00D3441B — 00D3441C 


Problem Determination: Coilect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D3441B 


Explanation: DRDS detected an invalid use of a conversation. 


a = Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNLXCNV 


eet End of Internal DB2 Information Sea eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


4-108 0B2 Messages and Codes 


00D3441C 


Explanation: Allocation of the Distributed Processing Services 
Block (DPSB) failed. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNLXQAL 


————— End of internal DB2 Information Bt ll 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested at the site of the DB2 abend. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine which sites the 
abending agent was connected to by examining the DSNL027 
and DSNL028 SYSLOG console messages at the site of the DB2 
abend. Obtain copies of the SYS1.LOGREC and SYSLOG data 
sets from each connected site, the SVC dump at the site of the 
DB2 failure, and any related dumps from each connected site. 


Refer to Section 3 and 4 of the Diagnosis Guide and Reference 
for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
55, 56. 


00D40001 — 00D44021 





IMS/VS Attachment Facility Codes (X‘ D4") 


00D40001 


Explanation: The IMS/VS attachment facility detected an 
invalid save area chain pointer. This condition occurs only if 
the save area is overlaid or if the save area pointer is invalid. 


System Action: The task is abended. 


System Programmer Response: If the abend occurred in an 
IMS/VS dependent region, restart the region. If the abend 
occurred in the IMS/VS control region, restart the connection. 
Determine the failing environment, and refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures 
and for information about dump analysis and service aids, and 
for information about the IMS/VS attachment facility trace. 


Problem Determination: Analyze the dump. Register 13 plus 
four bytes is the address of the invalid save area chain pointer. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4, 25, 26, 44. 


00D40008 


Explanation: The IMS/VS attachment facility command 
module’s ESTAE routine places this reason code in the variable 
recording area of SYS1.L.OGREC. The reason code indicates 
that the entry is not a standard DB2 entry. The reason code is 
followed by the current IMS/VS attachment facility trace entry, 
the first four characters of the command, the output destination, 
and the authorization ID. 


This message records information in the variable recording 
area (VRA). Refer to Section 5 of Diagnosis Guide and Refer- 
ence for more information on the VRA. 


— — Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNMCMDO 


a eae End of Internal DB2 Information a2 58 oe D| 


System Action: Every attempt is made to return to RTM with 
the retry option. If the retry is successful, a message is sent to 
the originating destination to show that the command failed. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Analyze the SYS1.LOGREC data. The 

log record contains the current IMS/VS attachment facility trace 
entry, the first four characters of the command, the output desti- 
nation, and the authorization ID for the failing command. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 3, 4, 25, 26, 44. 


00D44011 


. Explanation: The DB2-DL/I batch support cannot continue 
because the application program name was not specified in the 
DD!ITV02 SYSIN data set. 


Internal DB2 Information ” “| 


This abend reason code is issued by the following CSECT(s): 
DSNMTV01 


{ End of internal DB2 Information ee | 


System Action: The DB2-DL/| batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Place the name of the applica- 
tion program into the DDITV02 SYSIN data set and rerun the job. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
4, 31, 53. 


00D44021 


Explanation: The DB2-DL/I batch support cannot continue 
because the length of a parameter value specified in the 
DDITV02 SYSIN data set is incorrect. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV02 


| End of Internal DB2 Information sd 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Correct the DDITV02 SYSIN 
data set parameter value in error and rerun the job. Make sure 
the correct data set name is specified by the DDITV02 DD state- 
ment and the DCB RECFM is F or FB for the data set. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Probiem Determination: The parameter value length limits are 
the following: 


¢ DB2 subsystem name: 0 < SSN < 5. 

e LiT value <5. 

¢ DB2 initialization module name = 8. 

¢ DB2 optional resource translation module name < 9. 
* Region error option value < 2. 

¢ The command recognition value < 2. 

* The connection name < 9. 

© The DB2 plan name < 9. 

¢ The application program load module name < 9. 


Register 8 indicates the delimiter following the field in error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53. 


DB2 Codes 4-109 


00D44022 — 00D44031 


00D44022 


Explanation: The DB2-DL/I batch support cannot continue 
because the DDITV02 SYSIN data set cannot be opened or an 
end of file was reached before a record was read. 


—— =~: internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV02 


oe Sra? End of Internal DB2 Information eee eee | 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Correct the DDITV02 DD state- 
ment or data set in error and rerun the job. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: See if a DDITV02 data set exists and 
contains a properly formatted record. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53. 


00D44023 


Explanation: The DB2-DL/| batch support cannot continue 
because one or more of the DDITV02 SYSIN data set values are 
incorrectly specified. The end of the input record was detected 
before all the values were found. 


TC Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNMTV02 


ee End of Internal DB2 Information Mee et 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Correct the DDITV02 DD value 
or data set in error and rerun the job. Make sure the correct 
data set name is specified by the DDITVO2 DD statement and the 
DCB RECFNM is F or FB for the data set. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Check the DDITV02 DD SYSIN values 
for proper format. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53. 


00D44024 


Explanation: The DB2-DL/I batch support cannot continue 
because the DDITV02 SYSIN data set value for the DB2 initial- 
ization module refers to an incorrect module. 


4-110 DB2 Messages and Codes 


Internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNMTV02 


es End of Internal DB2 Information See eee a 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Correct the DDITV02 SYSIN 
DD value or data set in error by specifying DSNMIN10 as the 
initialization module and rerun the job. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Check the DDITV02 DD SYSIN value 
for the required parameter DSNMIN10. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53. 


00D44025 


Explanation: The DB2-DL/I batch support cannot continue 
because the DDITV02 SYSIN data set value for the DB2 region 
error option is incorrect. Only R, Q, A, or null (specified as ,,) 
are valid. 


[sys Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV02 


[| End of Internal DB2 Information | 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Correct the DDITV02 SYSIN 
DD value for the region error option of R, Q; A, or null and rerun 
the job. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Check the DDITV02 DD SYSIN value 
for the proper value of the error option of R, Q, A, or null. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53. 


00D44031 


Explanation: The DB2-DL/I batch support cannot continue 
because the DB2 subsystem name specified in the DDITV02 
SYSIN data set is not operational. This error can be caused 
because either the DB2 subsystem is not operational or an 
incorrect subsystem name was specified. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV03 


{oo End of Interna! DB2 Information eee | 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 


Operator Response: it may be necessary to start the DB2 sub- 
system specified. 


System Programmer Response: Correct the DDITVO2 DD 
SYSIN value for the DB2 subsystem name if it is incorrect and 
rerun the job. Otherwise have the operator start the DB2 sub- 
system. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Check the DDITV02 DD SYSIN value 
for the proper value of the DB2 subsystem name. Make sure 
the correct data set name is specified by the DDITV02 DD state- 
ment and the DCB RECFM is F or FB for the data set. The WAL 
contro! block in the dump contains information about the con- 
nection and the IMS/VS attach trace table. Refer to Section 7 of 
Diagnosis Guide and Reference for a description of the WAL 
control block. Field WALSSID indicates the name of the DB2 
subsystem being called. Refer to Section 5 of Diagnosis Guide 
and Reference for the format of the IMS/VS attach trac The last 
entry in the trace table will have an ID of ID00 and the CALL 
STATUS contains the two-byte return code and four-byte reason 
code of the failure. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44032 


Explanation: The DB2-DL/i batch support cannot continue 
because the DB2 create thread failed. This error occurs 
because either the DB2 subsystem is not considered opera- 
tional (DB2 may be terminating) or an incorrect plan name was 
specified. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV03 


ee ee End of Internal DB2 information el 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 


Operator Response: It may be necessary to start the DB2 sub- 
system specified. 


System Programmer Response: Either correct the DDITV02 
SYSIN data set value for the DB2 PLAN name or BIND/REBIND 
the DB2 plan if necessary. Otherwise, have the operator restart 
the DB2 subsystem. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Check the DDITV02 DD SYSIN value 
for the proper value of the DB2 PLAN name. The WAL control 


00D44032 — 00D44035 


block in the dump contains information about the connection 
and also the IMS/VS attach trace table. Refer to Section 7 of 
Diagnosis Guide and Reference for a description of the WAL 
control block. Field WALAID indicates the authorization name 
being used. Field WALRESN indicates the DB2 plan name 
being used. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for the format of the IMS/VS attach trace table. The last 
entry in the trace table will have an ID of ID00 or CTHD and the 
CALL STATUS contains the two-byte return code and four-byte 
reason code of the failure. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00044033 


Explanation: The DB2-DL/I batch support cannot continue 
because the application was selected as a dead lock victim. 


_ : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV03 


ee End of Internal DB2 Information te nee | 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 


Operator Response: it may be necessary to schedule the 
application program when lock out conditions are less likely to 
occur. 


System Programmer Response: Analyze the reason for the 
dead lock condition from information sent to the MVS console 
by DB2 as message number DSNT375I or DSNT376l. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
4, 31, 53, 54. 


00D44035 


Explanation: The DB2-DL/! batch support cannot continue 
because the PSB name used as the DB2 authorization ID begins 
with the character string SYSADM which is not allowed. 


[ —= Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTVO03 


eet ee End of Internal DB2 Information ee ae 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is a site problem. A PSB 
name beginning with SYSADM is being used as the authori- 
zation ID. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


DB2 Codes 4-111 


00D44036 — 00D44053 


Problem Determination: The PSB= parameter of the job step 
execute statement indicates the PSB name used. Register 3 
plus X'34' is the authorization ID specified. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44036 


Explanation: The DB2-DL/I batch support cannot continue 
because the authorization ID has been changed by the applica- 
tion program. 


a 7} Internal DB2 Information : nz | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV03 


ne End of internal DB2 Information ents Fl 


System Action: The DB2-DL/! batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is a site problem. The 
application program has modified the authorization ID. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: The authorization iD saved by DB2 
does not match the value in ASXBUSER. Control block modifi- 
cation has occurred. Register 3 plus X'34' is the changed 
value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44050 


Explanation: The DB2-DL/i batch support cannot continue 
because a DB2 prepare problem was detected. 


[~ ir Internal DB2 Information ~————— 


This abend reason code is issued by the following CSECT(s): 
DSNMTV05 


ee eee End of Internal DB2 Information See 


System Action: The DB2-DL/! batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 
System Programmer Response: This is an internal error. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: The WAL control block in the dump 
contains an IMS/VS attach trace table. Refer to Section 5 of 
Diagnosis Guide and Reference for the format of the IMS/VS 
attach trace table. The last entry in the trace table will have an 
ID of PREP. The CALL STATUS contains the two-byte return 
code and four-byte reason code of the failure. 


Collect the following diagnostic items listed in Appendix B, 
“Probiem Determination” on page X-5: 1, 4, 31, 53, 54. 


4-112 DB2 Messages and Codes 


00D44051 


Explanation: The DB2-DL/I batch support cannot continue 
because a DB2 commit continue problem was detected. 


[ = : Internal DB2 Information ~— a ase | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV05 


| a End of Internal DB2 Information poe 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 
System Programmer Response: This is an internal error. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Probiem Determination: The WAL control block in the dump 
contains an IMS/VS attach trace table. Refer to Section 5 of 
Diagnosis Guide and Reference for the format of the IMS/VS 
attach trace table. The last entry in the trace table will have an 
ID of COMC. The CALL STATUS contains the two-byte return 
code and four-byte reason code of the failure. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44052 


Explanation: The DB2-DL/I batch support cannot continue 
because a DB2 abort problem was detected. 


= Internal DB2 Information Se > 4. 


This abend reason code is issued by the following CSECT(s): 
DSNMTVO5 


| _ End of Internal DB2 Information jase Sates 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 
System Programmer Response: This is an internal error. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: The WAL control block in the dump 
contains an IMS/VS attach trace table. Refer to Section 5 of 
Diagnosis Guide and Reference for the format of the IMS/VS 
attach trace table. The last entry in the trace table will have an 
ID of ABRT. The CALL STATUS contains the two-byte return 
code and four-byte reason code of the failure. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44053 


Explanation: The DB2-DL/I batch support cannot continue. 
because a DL/1 XRST call problem was detected. 


a = Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV05 


{ End of Internal DB2 Information oem Fee a el 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an applica- 
tion program error. Check the PCB status code for a non-blank 
value, validate the PCB used for the call, and validate the 
parameters passed by the cal!. Correct the application 
program and resubmit the job. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Follow normal iIMS/VS debugging 
techniques to gather the IMS/VS documentation. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44054 


Explanation: The DB2-DL/I batch support cannot continue 
because an IMS/VS XRST call problem was detected. An XRST 
call, if issued, must be issued before any SQL call is issued; 
only one XRST call should be issued. 


| Internal DB2 {information ~~ ———7 


This abend reason code is issued by the following CSECT(s): 
DSNMTV05 


a End of Internal DB2 Information sie a 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an applica- 
tion program error. Correct the application program so it will 
issue the XRST call before any SQL statements are processed. 
Then resubmit the job. Also make sure only one XRST call is 
issued by the application program. 


Check the DDOTV02 data set to see if an INDOUBT unit of 
recovery has been erroneously aborted. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Follow normal IMS/VS debugging 
techniques to gather the DL/I documentation. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44055 


Explanation: The DB2-DL/I batch support cannot continue 
because an IMS/VS CHKP call problem was detected by 
IMS/VS. 


00D44054 — 00D44057 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV05 


Dee tees ee End of Internal DB2 Information eee 


System Action: The DB2-DL/i batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an applica- 
tion program error. Check the PCB status code for a non-blank 
value, validate the PCB used for the call, and validate the 
parameters passed by the call. Correct the application 
program and resubmit the job. 


Refer to Section 5 of Diagnosis Guide and Reference for mor 
information about failure analysis procedures. 


Problem Determination: Follow normal IMS/VS debugging 
techniques to gather the IMS/VS documentation. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44056 


Explanation: The DB2-DL/I batch support cannot continue 
because an IMS/VS ROLL or ROLB cail problem was detected 
by IMS/VS. 


(i Internal DB2 information ee 


This abend reason code is issued by the following CSECT(s): 
DSNMTV05 


L End of Internal DB2 Information eee: 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an applica- 
tion program error. Check the PCB status code for a non-blank 
value, validate the PCB used for the call, and validate the 
parameters passed by the call. Correct the application 
program and resubmit the job. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Follow normal IMS/VS debugging 
techniques to gather the IMS/VS documentation. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D44057 


Explanation: The DB2-DL/I batch support cannot continue 
because an IMS/VS call problem was detected by the DB2-DL/I 
batch support. An IMS/VS SYNC, ROLS, or SETS call is not 
allowed. 


DB2 Codes 4-113 


[ = Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNMTV05 


eee End of Internal DB2 Information ret 


System Action: The DB2-DL/I batch support cannot continue 
and processing is terminated. 


User Response: Notify the system programmer. 
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Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an applica- 
tion program error. Correct the application program to use 
supported IMS/VS calls and resubmit the job. 


Refer to Section 5 of Diagnosis Guide and Reference for more 
information about failure analysis procedures. 


Problem Determination: Follow normal IMS/VS debugging 
techniques to gather the IMS/VS documentation. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 31, 53, 54. 


00D70001 — 00D70003 





Data Space Manager Codes (X'D7') 


00070001 


Explanation: Either the data space manager (DSM) subcompo- 
nent of DB2 could not access some storage group definition, or 
the storage group contains no volume IDs. Possible sources of 
the error include use of an incorrect name for the storage 
group and removal of all volume IDs via ALTER STOGROUP 
without providing new ones. 


[Internal DB2 Information ~~ | 


This reason code is issued by the following CSECT(s): 
DSNPGSGI 


ee End of Internal DB2 Information Rey | 


System Action: A ‘resource not available' code is returned to 
the caller. 


User Response: If you are unable to resolve the problem your- 
self, notify the system programmer or database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, check the SQLCA for the name 
of the storage group. Check this storage group (via an SQL 
SELECT on SYSIBM.SYSSTOGROUP) to ensure that it exists. 
Check for associated SYSIBM.SYSVOLUMES table entries to 
see if any volume IDs exist for this storage group. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about finding the SQLCA. 


Problem Determination: Obtain output listing from SELECT * 
FROM SYSIBM.SYSSTOGROUP and SELECT * FROM 
SYSIBM.SYSVOLUMES, details of the request that resulted in 
this code, and contents of the SQLCA. Aiso obtain operator’s 
console sheet showing related messages, if any. Use this doc- 
umentation to determine the cause of the problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 13, 14, 31, 34. 


00D70002 


Explanation: The required data set(s) are not available to the 
data space manager (DSM) subcomponent of DB2. This is 
probably a user error. For example, the user may have for- 
gotten to create the needed VSAM data cluster(s) via access 
method services prior to issuing a CREATE TABLE SPACE 
request with the 'USING VCAT' parameter specified. 


i — ey ee Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPCPSO, DSNPXTNO 


[et eee End of Internal DB2 tnformation a 


System Action: A ‘resource not available' code is returned to 
the end user. 


User Response: If you are unable to resolve the problem your- 
self, notify the system programmer or database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, make the needed data set 
available and/or be sure it is cataloged in the appropriate inte- 
grated catalog facility (ICF) catalog. 


The data set name(s) appears in the SQLCA, in the 
DSNP-prefixed message that contained this code, or in an 
earlier DSNP-prefixed message for the same user (Same con- 
nection and correlation IDs). Refer to Section 5 of Diagnosis 
Guide and Reference for information about finding the SQLCA. 


lf the data set name is correct, is cataloged, and appears in the 
VTOC, run the access method services DIAGNOSE command 
against the integrated catalog facility (ICF) catalog identified by 
the first qualifier of the data set name. The DIAGNOSE 
command is described in Data Facility Extended Function: 
Access Method Services Reference and in Data Facility 
Extended Function: Access Method Services Administration and 
Services. 


Problem Determination: Obtain listings of the integrated 
catalog facility (ICF) catalog and VTOC showing existence of the 
data set, details of the request that led to this code, and the 
contents of the SQLCA. Also obtain operator’s console sheet 
showing related messages, if any. Use this documentation to 
determine the cause of the problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 11, 13, 14, 31, 
34. 


00D70003 


Explanation: Some or all of the data set(s) already exist. The 
data space manager (DSM) subcomponent of DB2 has discov- 
ered the preexistence of a data set having the same name as 
one it was about to create. The name of the data set appears in 
the SQLCA and/or in message DSNPO002! (DEFINE FAILED FOR 
data-set-name). 


Refer to Section 5 of Diagnosis Guide and Reference for infor- 
mation on finding the SQLCA. Refer to Section 2 (Volume 1) of 
Administration Guide for data set naming conventions. 


This may occur if a user creates a data set with VSAM access 
method services (intending to use it for a table space or index), 
then creates the table space or index via SQL CREATE state- 
ment, but forgets to specify USING VCAT. 


Another possibility is that the data set remained from some 
prior, unsuccessfully completed DROP or backout operation of 
DB2. This failure would probably occur if the data set or inte- 
grated catalog facility (ICF) catalog were unavailable at the time 
of the DROP or backout. For example, packs may be offline, or 
other operational problems may exist. In this case, the table 
space would be dropped, but the data sets could remain and be 
brought back online at a later time. 


There should have been some indication of this type of failure 
at the time it occurred. (for example, some DSNP-prefixed 
message indicating the data set was not deleted). You might 
check recent console sheets for such a message; however, it 
may have happened a long time ago. 
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00D70004 — 00D70006 


— Internal DB2 information | 


This reason code is issued by the following CSECT(s): 
DSNPDFN1 


| send of Internal DB2 Information | 


System Action: Error indication is returned to the end user. 


User Response: If you are unable to resolve the problem your- 
self, notify the system programmer or database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, either use access method ser- 
vices to delete the data set or use a different name for the table 
or index you are trying to create. 


if the data set name is correct, is cataloged, and appears in the 
VTOC, run the access method services DIAGNOSE command 
against the integrated catalog facility (I\CF) catalog identified by 
the first qualifier of the data set name. The DIAGNOSE 
command is described in Data Facility Extended Function: 
Access Method Services Reference and in Data Facility 
Extended Function: Access Method Services Administration and 
Services. 


Problem Determination: Information is needed concerning the 
history of the use of this data set; that is, of the table 
space/index name in conjunction with this database name. 
Listings of the consoie, integrated catalog facility (ICF) catalog, 
and VTOC may also be needed, with details of the request that 
resulted in this code, and contents of the SQLCA. Also obtain 
operator’s console sheet showing related messages, if any. 
Use this documentation to determine the cause of the probiem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 10, 11, 13, 14, 31, 
34. 


00D70004 


Explanation: Certain data set(s) are pending deletion. Cre- 
ation of a new data set is blocked by the presence of the name 
on a drop list. This is usually a user error. It usually occurs 
when the user has dropped an old object (table space, index, 
and so forth) and then attempted to redefine it without commit- 
ting the drop. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPCPSO, DSNPDFN1 


betes End of Internal DB2 Information rere te 


System Action: Error indication is returned to the user. 


User Response: You must commit the drop prior to redefining. 
Notify the system programmer or database administrator, if 
necessary. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: The user must commit the 
drop of the data set on the drop list. Collect the materials listed 
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in the Problem Determination section of this message to deter- 
mine the specific cause of the problem. 


Problem Determination: Documentation is needed showing 
activities from the last committed action up to and including 
details of the request that resulted in this code. You also need 
to examine the contents of the SQLCA. 


Refer to Section 5 of Diagnosis Guide and Reference for infor- 
mation about finding the SQLCA. Also obtain operator’s 
console sheet showing related messages, if any. Use this doc- 
umentation to determine the cause of the problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 13, 31, 34. 


00D70005 


Explanation: The specified data set was AMS USER DEFINED. 
it does not have the required DB2 attributes. 


| - Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPSCTO 


_——— End of Internal DB2 Information eae 


System Action: No action is taken with the named data set. An 
error code is returned and a dump is not taken. 


Operator Response: Notify the system programmer. 


System Programmer Response: Delete the named data set 
and DEFINE it with the correct attributes. Refer to Section 2 
(Volume 1) of Administration Guide for the correct data set defi- 
nition attributes. 


Problem Determination: Obtain an AMS LISTCAT for the 
named data set’s attributes. 


00D70006 


Explanation: The data set(s) are not owned by this DB2 sub- 
system. The data sets backing a table space or index can be 
deleted only by the data space manager (DSM) subcomponent 
of the DB2 subsystem that created them or by one having the 
same authorization ID at the time of installation. This is a 
safety feature to restrict DSM from deleting data sets that might 
have been created by the user but that have a name that 
matches the one we are trying to delete. This safety feature 
also prevents the deletion of data sets that might have been 
created by some other DB2 subsystem and that are still needed 
there. 


oo ~ Internal DB2 Information : | 


This reason code is issued by the following CSECT(s): 
DSNPDLT1 


[ End of Internal DB2 Information ee 


System Action: The data sets remain intact. 


User Response: If you are unable to resolve the problem your- 
self, notify the system programmer or database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, check the name of the data 
set(s) in question. Delete those names, then issue appropriate 
DROP requests on the DB2 subsystem that created them (see 
the 'OWNER' parameter in the integrated catalog facility (ICF) 
catalog entry for the data set), or issue access method services 
DELETE CLUSTER statements directly. 


Problem Determination: Obtain integrated catalog facility (CF) 
catalog and VTOC listings, details of the request that resulted in 
this code, and contents of the SQLCA. Also obtain operator’s 
console sheet showing related messages, if any. This doc- 
umentation will assist you in determining the cause of the 
problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 11, 13, 14, 31, 
34. 


00D70007 - 


Explanation: The specified data set must be cataloged in an 
ICF catalog. It was found in a non-ICF catalog. 


[- ~~ _ Internal DB2 Information SS 


This reason code is issued by the following CSECT(s): 
DSNPSCTO 


| snd of Internal DB2 Information 


System Action: No action is taken with the named data set. An 
error code is returned and a dump is not taken. 


Operator Response: Notify the system programmer. 


System Programmer Response: Delete the named data set 
and re-DEFINE using an ICF catalog 


Problem Determination: Obtain an AMS LISTCAT for the 
named data set’s catalog types. Refer to Section 2 (Volume 1) 
of Administration Guide for the correct catalog usage. 


00D70011 


Explanation: The data space manager (DSM) subcomponent of 
DB2 has been requested to extend a table space or index 
space, but the table space or index space has already been 
extended to its maximum size. The size of a partition depends 
on the number of partitions, and can be 1, 2 or 4 gigabytes. [f 
the table space or index space is not partitioned, the maximum 
size is 64 gigabytes (32 data sets—' pieces '—of 2 gigabytes 
each). 


For the name of the data set from which the name of the table 
space, index space, and/or partition can be derived, see 
message DSNP001I or DSNPOO7!I and/or the SQLCA. Refer to 
Section 2 (Volume 1) of Administration Guide for data set 
naming conventions. 


j : Internal DB2 Information ~— ~~ ~ | 


This reason code is issued by the following CSECT(s): 
DSNPXTNO 


ee End of Internal DB2 Information beet 


System Action: No extension is done. Whatever operation was 
in progress is terminated and uncommitted activities are 
backed out. 


00D70007 — 00D70012 


User Response: If you are unable to resolve the problem your- 
self, notify the system programmer or database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, if the table space is partitioned 
and there is space in other partitions, you may be able to rede- 
fine the table space with new partitioning parameters so that 
the data that has overloaded this partition is directed to others. 
If the table space is not partitioned, you probably have more 
than one table residing in this table space. Define another 
table space, unload this one, then reload the tables into the 
separate spaces. (Be aware that this is a very large amount of 
data to move. Careful planning is recommended.) 


Problem Determination: If you believe the table space or index 
space has not yet reached maximum size, provide listings of 
the console, integrated catalog facility (ICF) catalog, and VTOC. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 11, 13, 14, 31, 


34. 


00D70012 


Explanation: A password or security error has occurred. An 
attempt to access a integrated catalog facility (ICF) catalog 
entry for a cluster (data set) failed because of some security 
violation. This is probably a user error. It may be caused either 
by the incorrect specification of a password or the changing of 
the password in the DB2 Catalog (via SQL ALTER) but not in the 
integrated catalog facility (ICF) catalog (via access method ser- 
vices ALTER) or vice versa. 


(a internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNPSCTD, DSNPSCTO, DSNPAVLR 


le Ee a End of Internal DB2 Information s= f= 


System Action: A ‘resource not available' code is returned to 
the end user. 


Operator Response: Notify the system programmer or data- 
base administrator. 


User Response: Ensure that the correct password is being 
used. If you are unable to resolve the problem yourself, notify 
the database administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, check the passwords and/or 
RACF authorizations. 


Problem Determination: Obtain output from SQL SELECT * 
FROM SYSIBM.SYSTABLESPACE and (if storage group related) 
SELECT * FROM SYSIBM.SYSSTOGROUP. Also obtain inte- 
grated catalog facility (ICF) catalog listing, details of the request 


' that resulted in this code, and contents of the SQLCA. 


Refer to Section 5 of Diagnosis Guide and Reference for infor- 
mation on finding the SQLCA. Also obtain operator’s console 
sheet showing related messages, if any. This documentation 
will assist you in determining the cause of the problem if it is 
not merely an incorrect password. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 13, 14, 31, 34. 
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00D70013 — 00D70017 


00D70013 


Explanation: A required integrated catalog facility (ICF) 
catalog does not exist or is inaccessible. An attempt to access 
an integrated catalog facility (ICF) catalog entry for a cluster 
(data set) failed. This is probably a user error. 


” Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPSCTD, DSNPSCTO, DSNPAVLR 


a End of Internal DB2 Information Se | 


System Action: A 'resource not available’ code is returned to 
the end user. 


User Response: if you are unable to resolve the problem your- 
self, notify the system programmer or database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, check to be sure the proper 
catalog name has been specified and is available to DB2. 
Check the associated DSNP012!I message on the operator’s 
console for the integrated catalog facility (ICF) catalog return 
and reason codes, and refer to the appropriate MVS publication 
for a description of IDC3009I. For additional information, see 
the description of DSNP012I. 


Problem Determination: Obtain details of the request that 
resulted in this code, and contents of the SQLCA. Also obtain 
operator’s console sheet showing related messages, if any. 
This documentation will assist you in determining the cause of 
the problem. For additional information, see description of 
DSNPO12I. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 13, 31, 34. 


00D70014 


Explanation: An attempt to extend a data set failed, because a 
problem was detected in media manager services. 


— ~~ _ Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNPXTNO 


ee End of Internal DB2 Information pee ee ell 


System Action: Abori the request. 


User Response: Notify the operator, system programmer, or 
database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, check the packs available to 
the data set. They may merely be full or the data set may have 
reached its maximum allowable extents. For additionai infor- 
mation, see the description of message DSNPOOTI. 


Problem Determination: Obtain console sheet showing associ- 
ated DSNP001!, DSNOO007!, or DSNP011I messages and any 
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related messages preceding them. This documentation will 
assist you in determining the cause of the problem. For addi- 
tional information, see the description of these messages. 


Collect the foliowing diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 4, 5, 10, 11, 13, 
31, 34. 


00D70015 


Explanation: An attempt to update the high-used RBA for a 
data set failed in media manager services. 


| Internal DB2 Information 7: =, 


This reason code is issued by the following CSECT(s): 
DSNPXTNO, DSNPIPP, DSNPRSPO, DSNPRSTO 


Mes ean End of Interna! DB2 Information ee, 


System Action: Abort the request. 
User Response: Notify the system programmer. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator (DBA), if appropriate. The DBA should be made aware of 
the extend problem. However, this is probably a system 
problem. 


Problem Determination: Obtain console sheet showing associ- 
ated DSNP001!1, DSNOO07i, or DSNP011! messages and any 
related messages preceding them. This documentation will 
assist you in determining the cause of the problem. For addi- 
tional information, see the description of these messages. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 4, 5, 10, 11, 13, 
31, 34. 


00D70017 


Explanation: An error occurred when attempting to obtain 
information from an integrated catalog facility (ICF) catalog. 


| Internal DB2 Information ~~ ———S “4 


This reason code is issued by the following CSECT(s): 
DSNPSCTD, DSNPSCT0, DSNPAVLR 


[End of internal DB2 Information ___—_| 


System Action: Abort the request. 


User Response: Notify the system programmer or database 
administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, ensure that the proper packs 
and catalog are online and operating properly. 


Problem Determination: See message DSNPO12i. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 4, 5, 10, 13, 31, 
34. 


00D70018 


Explanation: This is a DB2 internal error. DSNPGNPO was 
called for a partitioned table space or index space. Its function 
applies only to nonpartitioned table spaces or index spaces. 


| Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNPGNPO 


ee End of internal DB2 information eee! 


System Action: Abort the request. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Collect the materials listed in 
the Problem Determination section of this message, and refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: Request a dynamic dump. Inthe 
dump, the second parameter passed to DSNPGNPO identifies 
the table space or index space. The third parameter is the 
table space or index space object descriptor block (OBD). The 
OBD indicates whether or not the table space or index space is 
partitioned. If it is partitioned, the calling module is in error. If 
it is not partitioned, the test in DSNPGNPO must be at fault. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 13, 14, 31, 34 


00D70019 


Explanation: The data space manager (DSM) subcomponent of 
DB2 could not release the extend lock it acquired against a data 
set during an attempt to extend that data set. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPXTNO 


Veeco cone oe End of Internal DB2 Information Pree 


System Action: The SQL request that led to the abend is termi- 
nated, and the unit of recovery that issued the request is 
backed out. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: investigate the DSM mes- 
sages associated with this condition (at least message 
DSNP0O151) for clues to the problem. If necessary, refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: This problem is probably the result of 
either: (1) an attempt by DSM to free a lock it did not hold or, (2) 
a problem in IRLM. The IRLM return and reason codes appear 
in the associated DSNP015!I message. For additional informa- 
tion, see the description of this message. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 4, 5, 10, 13, 31, 
34. 


00D70018 — 00D70023 


00D70021 


Explanation: The data space manager (DSM) subcomponent of 
DB2 could not write a required log record. 


Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPDFN1 


ase ee End of internal DB2 Information eee aon 


System Action: Abort the request. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Collect the materials listed in 
the Problem Determination section of this message. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures and for information on the DB2 log. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 13, 31, 32, 34. 


00D70022 


Explanation: The data space manager subcomponent of DB2 is 
unable to acquire a needed lock. The extend request can not 
be completed. 


| 7 ~~ Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPXTNO 


Vines eee tered End of Internal DB2 Information ae 


System Action: Abort the request. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Obtain documentation from 
message DSNP014I. For more information about failure anal- 
ysis procedures, refer to Section 5 of Diagnosis Guide and Ref- 
erence. 


Problem Determination: See message DSNPO014I. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 13, 31, 34. 


00D70023 


Explanation: There is an insufficient amount of space in 
primary allocation to format control pages. 


| Internal DB2 Information | 
This reason code is issued by the following CSECT(s): DSNPIPP 


a End of Internal DB2 Information | 


System Action: The requested table space or index space cre- 
ation is backed out. 


User Response: Notify the system programmer or database 
administrator. 
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00D70024 — 00D70028 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, increase the primary allo- 
cation value in the data set that was defined directly via access 
method services. (This should not happen for storage group 
related data sets, because the DB2 interpreter ensures a suffi- 
cient setting for the primary value.) 


Problem Determination: Obtain integrated catalog facility (ICF) 
catalog and VTOC listings, details of the request that led to this 
code, and contents of the SQLCA. 


Refer to Section 5 of Diagnosis Guide and Reference for infor- 
mation about finding the SQLCA. Results of SQL SELECT * 
FROM SYSIBM.SYSTABLESPACE may also be useful. Also 
obtain the operator’s console sheet showing related messages, 
if any. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 11, 14, 31, 34. 


00D70024 


Explanation: No data sets exist for a nonpartitioned table 
space or index space. Because at least one existed at create 
time, a serious problem has occurred for this table space or 
index space. The name of the data set that DSM expected to 
find for the table space or index space appears in message 
DSNPO12! and/or in the SQLCA, with the reason code. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about finding the SQLCA. 


| internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNPGNPO 


[bers oe tees End of internal DB2 Information eee 


System Action: Abort the request. 


User Response: Notify the system programmer or database 
administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, ensure that the pack con- 
taining the data set is available to DB2 and that the data set has 
not been inadvertently deleted by an external access method 
services or other DASD operation. 


If the data set name is correct, is to be cataloged, and appears 
in the VTOC, run the access method services DIAGNOSE 
command against the integrated catalog facility (ICF) catalog 
identified by the first qualifier of the data set name. The DIAG- 
NOSE command is described in Access Method Services Refer- 
ence and Access Method Services Administration and Services. 


Problem Determination: Obtain integrated catalog facility (ICF) 
catalog and VTOC listings, details of the request that led to this 
code, and contents of the SQLCA. Also obtain operator’s 
console sheet showing related messages. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 11, 13, 31, 34. 
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00D70025 


Explanation: An access method services request failed. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNPAMSI 


L End of internal DB2 Information ee ee 


System Action: Abort the request. 


User Response: Notify the system programmer or database 
administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Examine messages DSNPOO9I 
and DSNPO10! on the operator’s console for the access method 
services messages they encompass. Refer to the appropriate 
MVS publication for information about specific access method 
services messages received. 


Problem Determination: See the message DSNPOO9I 
description. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 11, 13, 31, 34. 


00D70027 


Explanation: The secondary allocation value is 0. No physical 
extension is done. 


| ee Internal DB2 Information : | 


This reason code is issued by the following CSECT(s): 
DSNPXTNO 


fo End of Internal DB2 Information eee es 


System Action: The request to extend the data set is aborted. 


User Response: Notify the system programmer or database 
administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, if you intended to allow phys- 
ical extension of the data set, change its secondary value toa 
nonzero quantity. 


Problem Determination: Obtain integrated catalog facility (ICF) 
catalog and VTOC listings, and (if storage group-defined) the 
output from SELECT * FROM SYSIBM.SYSSTOGROUP. Also 
obtain details of the request that resulted in this code, contents 
of the SQLCA, and the operator’s console sheet showing 
related messages, if any. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 10, 11, 13, 14, 31, 
34. 


00D70028 


Explanation: An HSM request for the recall of a migrated data 
set failed. 


Internal DB2 Information aE. | 


This abend reason code is issued by the following CSECT(s): 
DSNPHRCO 


| sEnd of Internat DB2 Information 


System Action: The HSM recall is aborted by data space 
manager and control returns to the function that issued the 
recall request. The higher level function will not necessarily ter- 
minate processing since the data set may have already been 
recalled. 


User Response: If processing was terminated, notify the 
system programmer or database administrator. 


Operator Response: If processing was terminated, notify the 
system programmer or database administrator. 


System Programmer Response: If processing was terminated, 
investigate the reason for the HSM failure via messages issued 
to the MVS operator's console. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: Refer to the problem determination 
section(s) of the associated DB2 and HSM messages which 
were issued to the MVS operator’s console. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 1. 


00D70030 


Explanation: Unexpected reason code was received from 
some DB2 subcomponent invoked by data space manager 
(DSM). 


Almost any DSNP module can issue this reason code. 
System Action: Abort the request. 

User Response: Notify the operator or system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: There is not much the system 
programmer can do here, but see register 2 in the accompa- 
nying dump for the unexpected code. Its description may 
provide a clue to the type of problem. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


Problem Determination: Obtain a listing of the SQL request 
that resulted in this code and a listing of the contents of the 
SQLCA. Also obtain operator’s console sheet showing related 
messages, if any. There should be at least one DSNP-prefixed 
message containing the '00D70030' code. Messages preceding 
it from other subcomponents (having other prefixes beginning 
with DSN) may provide additional details about the problem. 


Collect the following diagnostic items listed in Appendix B, 
“Probiem Determination” on page X-5: 1, 2, 13, 31, 34. 


f 


00D70030 — 00D79999 


00D70100 


Explanation: A requested resource is not available. Either the 
data space manager (DSM) or some subcomponent that it 
invoked discovered that some resource is not available. The 
name and type of the resource and the reason it is unavailable 
are placed in the CT control block by the subcomponent that 
made the discovery. This information is made available to the 
end user in the SQLCA and/or messages. The reason code in 
the CT/SQLCA contains the identifier of the subcomponent that 
discovered the problem. 


Almost any DSNP module can issue this reason code. 
System Action: Abort the current request. 


User Response: Notify the operator, system programmer, or 
database administrator. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, determine what resource was 
unavailable (from SQLCA information) and, if it is something 
you can control, make it available. Refer to Section 5 of Diag- 
nosis Guide and Reference for information about finding the 
SQLCA. 


Problem Determination: See the Problem Determination 
section in the description of the code that appears in the 
SQLCA or CTRURESN field of the CT and/or in the description of 
any associated console messages. Obtain details of the 
request that resulted in this code, and contents of the SQLCA. 
Also obtain operator’s console sheet showing related mes- 
sages, if any. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 13, 31, 34. 


00D79999 


Explanation: A severe error has occurred. For example, an 
invalid data space manager (CSM) function is invoked. 


Almost any DSNP module can issue this reason code. 
System Action: Abort the request. 

User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Obtain the console sheet, dump, 
details of the request that led to this code, and contents of the 
SQLCA. Use these in conjunction with the procedures in Section 
5 of Diagnosis Guide and Reference. Also refer to Section 5 of 
Diagnosis Guide and Reference for information on finding the 
SQLCA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 13, 31, 34. 


DB2 Codes 4-121 


00D90000 — 00D92001 





Recovery Manager Reason Codes (X'D9') 


00D90000 


Explanation: A recovery manager module received control 
from its FRR for retry and found an invalid retry point identifier. 
The name of the module in which the failure occurred appears 
in the SYS1.LOGREC entry showing this reason code in register 
15. 


System Action: Standard DB2 diagnostic information is pro- 
vided. The error is recorded in SYS1.LOGREC, an SVC dump is 
scheduled, and DB2 subsystem termination is requested. The 
subsystem termination reason code reflects the function for 
which retry was unsuccessfully attempted. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: This is a secondary sub- 
system error. Obtain a copy of SYS1.LOGREC and the SVC 
dump for this failure and for the original failure that resulted in 
the retry attempt. 


Problem Determination: Examine the SYS1.LOGREC informa- 
tion and the dumps from both the original failure and this 
second failure to determine if the recovery parameter area was 
damaged or if retry incorrectly restored registers for the main- 
line module. 


00D90002 


Explanation: The recovery manager startup notification routine 
received an error return code from the recovery log manager 
when attempting to read a recovery manager status table 
(RMST) record from the bootstrap data set (BSDS) in one of the 
following cases: 


¢ When reading the record containing the RMST header. The 
first copy was successfully read, but the second copy could 
not be found. 

* When reading records containing the RMST entries. A 'no 
record found' condition was encountered before all entries 
were read. 

¢ When reading either a header record or an entry record. 
The record exceeded its expected length. 


[ ean Internal DB2 information ~— ~| 


This abend reason code is issued by the following CSECT(s): 
DSNRITO3 


ee End of Internal DB2 Information a ee ail 


System Action: The recovery manager has no functional 
recovery routine (FRR) in place when this abend occurs. It 
relies on its invoker, the facility startup function, to perform 
SYS1.LOGREC recording and to request a dump. The DB2 sub- 
system then terminates with a '00E80100' abend reason code. 
Refer to “Section 4. DB2 Codes” on page 4-1, for information 
pertaining to the abend reason code. 


System Programmer Response: This is a DB2 subsystem 
error. Print the contents of the BSDS (both copies if dual BSDS 
is in use). Print the dump and the contents of SYS1.LOGREC. 
Collect the materials mentioned in the the Problem Determi- 
nation section of this message. 


Problem Determination: Examine the BSDS contents to deter- 
mine how it differs from what should be there. All RMST 


records in the BSDS are identified by their VSAM key. When 
DB2 is first installed or when a newly formatted BSDS is used, 
there are no RMST records. At all other times, there are two 
RMST header records and six RMST entries in each BSDS. 


During DB2 initialization, if the RMST header record with key 
‘03000001' cannot be read, the recovery manager (DSNRIT03) 
creates and writes two copies each of the RMST entry records 
and the RMST header records (Key '0300000x', where x = 1 or 
2). The RMST header record with key '03000001' is written last. 
Thus, if the record with that key exists, all other RMST records 
exist. The data portion of the records is described by 
RMSTHDR and RMSTE. 


After initialization, at the completion of each DB2 checkpoint, 
one RMST header record is updated to reflect the log RBA for 
the most recent checkpoint. The RMST header record with the 
highest value in the field RMSTMRCK is the most current 
header record. 


in the most current RMST header record, the field RMSTKYCE 
contains the BSDS key of the first record containing the most 
current RMST entries. Keys for the RMST entry records are 
'030101xx' and '030102xx', where 'xx' is 01, 02, or 03. Three 
records are required to record the 256 RMST entries. 


One set of three RMST entry records is updated whenever the 
status of one or more resource managers changes (finish 
restarting or finish terminating) alternating between the two key 
sets ('030101xx' and '030102xx'). The alternate recording pro- 
tects against partial destruction of a complete and consistent 
image of the entries. Only after successfully updating the entire 
set of RMST entry records is the most recent RMST header 


. record externalized. 


After you have determined whether one copy is incorrect, 
recover the BSDS by following the procedures described in 
Section 5 (Volume 2) of Administration Guide. 


00D92001 


Explanation: The checkpoint/restart serial controller 
(DSNRCRSC) FRR invoked DB2 subsystem termination, because 
an unrecoverable error was detected while processing a 
request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


[~ eae Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRCRSC 


Pe ee End of Internal DB2 Information eee, 


System Action: Subsystem termination is initiated. Standard 
DB2 diagnostic information is recorded in SYS1.LOGREC, and 
an SVC dump is requested for the associated abend. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


‘System Programmer Response: Obtain a copy of the 


SYS1.LOGREC and the SVC dump for the original error, and 
follow the instructions associated with it. 


Problem Determination: See the original error. 


DB2 Codes 4-123 


00D92002 — 00D92012 


00D92002 


Explanation: The checkpoint request servicer (DSNRCRQS) 
FRR invoked DB2 subsystem termination, because an unrecov- 
erable error was detected while processing a checkpoint 
request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


| internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNRCRQS 


eet ate End of Interna! DB2 Information ee 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00D92003 


Explanation: The restart request servicer (DSNRRRQS) FRR 
invoked DB2 subsystem termination, because an unrecoverable 
error was detected while processing a restart request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


fp ee re internal DB2 Information ~~ | 


This reason code is issued by the following CSECT(s): 
DSNRRRQS 


—_——— End of Internal DB2 Information Ses 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump for the original error. 


Probiem Determination: See the original error. 


00D92004 


Explanation: The shutdown checkpoint controller (DSNRCSHT) 
FRR invoked DB2 subsystem termination, because an unrecov- 
erable error was detected while processing a shutdown check- 
point request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


4-124 DB2 Messages and Codes 


(oo ee Interna! DB2 Information : | 


This reason code is issued by the following CSECT(s): 
DSNRCSHT 


ere End of internal DB2 Information _ 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00D92011 


Explanation: An invalid URE was found during checkpoint 
processing. An overlay of the URE may have occurred. 


| Internal DB2 Information ~ ~ 3 


This abend reason code is issued by the following CSECT(s): 
DSNRPBCW 


ee End of Internal DB2 Information | 


System Action: The checkpoint process will ABEND to prevent 
a damaged URE from being written out to the log, and the sub- 
system will be terminated. This is to prevent the loss or incor- 
rect processing of a DB2 unit of recovery. DB2 Restart will use 
the previous checkpoint and apply all the DB2 log records up to 
the point of failure. Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is scheduled. 


Operator Response: Collect the SYS1.LOGREC and SVCDUMP, 
and notify the system programmer. Restart DB2. 


System Programmer Response: Collect the following diag- 
nostic items listed in Appendix B, “Problem Determination” on 
page X-5: 1, 3, 5. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination:. Examine the SVCDUMP and the DB2 
Trace Table in the dump to determine the cause of the URE 
overlay. 


00D92012 


Explanation: An invalid RURE was found during checkpoint 
processing. An overlay of the RURE may have occurred. 


Internal DB2 Information ~~ “| 


This abend reason code is issued by the following CSECT(s): 
DSNRPBCW 


poe es End of Internal DB2 Information eee tetee| 


System Action: The checkpoint process will ABEND to prevent 
a damaged RURE from being written out to the log, and the sub- 
system will be terminated. This is to prevent the loss or incor- 
rect processing of a DB2 unit of recovery. DB2 Restart will use 
the previous checkpoint and apply all the DB2 log records up to 
the point of failure. Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is scheduled. 


Operator Response: Collect the SYS1.L.OGREC and SVCDUMP, 
and notify the system programmer. Restart DB2. 


System Programmer Response: Collect the following diag- 
nostic items listed in Appendix B, “Problem Determination” on 
page X-5: 1, 3, 5. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: Examine the SVCDUMP and the DB2 
Trace Table in the dump to determine the cause of the RURE 
overlay. 


00D92021 


Explanation: An invalid URE was read from the log during the 
current status rebuild phase of restart. Restart cannot process 
the damaged URE. 


Wy oe ~~ Internal DB2 Information ~ — 


This abend reason code is issued by the following CSECT(s): 
DSNRPLCS 


(ee eee es End of Internal DB2 Information Boe as 


System Action: The restart processing will ABEND, which will 
terminate the subsystem. This is to prevent the loss or incor- 
rect processing of a DB2 unit of recovery. 


Standard DB2 diagnostic information is recorded in 
SYS1.LOGREC, and an SVC dump is scheduled. The first 4 
digits of the RBA of the invalid log record is contained in reg- 
ister 3 and the last 8 digits in register 4. 


Operator Response: Do not attempt to restart DB2 until the 
error is resolved. Notify the system programmer and collect 
the following diagnostic items listed in Appendix B, “Problem 
Determination” on page X-5: 1, 3, 5. 


System Programmer Response: Print the BSDS using the Print 
Log Map utility (DSNJU004). Find the checkpoint queue in the 
output listing from DSNJU004. 


Next, run the Change Log Inventory utility (DSNJU003) to create 
a conditional restart record with the CHKPTRBA option speci- 
fying the Begin Checkpoint RBA found in the second entry of the 
checkpoint queue. Restart DB2 using the conditional restart 
record found. If the same failure occurs, repeat the conditional 
process using the next Begin Checkpoint RBA in the checkpoint 
queue. 


Repeat this process, going down the checkpoint queue until 
DB2 restarts. This will be prior to the time when the invalid 
URE was written to the log. The restart process will then be 
able to apply all the log records to the end of the log. For infor- 
mation on running the Print Log Map and Check Log Inventory 
utilities, see the DB2 Reference Manual. 


Refer to Section 5 of Diagnosis Guide and Reference for other 
failure analysis procedures. 


Problem Determination: See above. 


00D92021 — 00D93001 


00092022 


Explanation: An invalid RURE was read from the log during the 
current status rebuild phase of restart. Restart cannot process 
the damaged RURE. 


[ 1 Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNRPLCS 


ees End of Internal DB2 Information rae 


System Action: The restart processing will ABEND, which will 
terminate the subsystem. This is to prevent the loss or incor- 
rect processing of a DB2 unit of recovery. 


Standard DB2 diagnostic information is recorded in 
SYS1.LOGREC, and an SVC dump is scheduled. The first 4 
digits of the RBA of the invalid log record is contained in reg- 
ister 3 and the last 8 digits in register 4. 


Operator Response: Do not attempt to restart DB2 until the 
error is resolved. Notify the system programmer and collect 
the following diagnostic items listed in Appendix B, “Problem 
Determination” on page X-5: 1, 3, 5. 


System Programmer Response: Print the BSDS using the Print 
Log Map utility (DSNJU004). Find the checkpoint queue in the 
output listing from DSNJU004. 


Next, run the Change Log Inventory utility (DSNJU003) to create 
a conditional restart record with the CHKPTRBA option speci- 
fying the Begin Checkpoint RBA found in the second entry of the 
checkpoint queue. Restart DB2 using the conditional restart 
record found. If the same failure occurs, repeat the conditional 
process using the next Begin Checkpoint RBA in the checkpoint 
queue. 


Repeat this process, going down the checkpoint queue until 
DB2 restarts. This will be prior to the time when the invalid 
RURE was written to the log. The restart process will then be 
able to apply ali the log records to the end of the log. For infor- 
mation on running the Print Log Map and Check Log Inventory 
utilities, see the DB2 Reference Manual. 


Refer to Section 5 of Diagnosis Guide and Reference for other 
failure analysis procedures. 


Problem Determination: See above. 


00D93001 


Explanation: The commit/abort FRR (DSNRCAFR) invoked DB2 
subsystem termination, because an unrecoverable error was 
detected during must-complete processing for phase 2 of a 
commit-UR request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


| internal DB2 Information ~ | 


This reason code is issued by the following CSECT(s): 
DSNRCAFR, DSNRUCO02 


ee End of Internal DB2 Information ee] 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


DB2 Codes 4-125 


OOD9300F — 00D93100 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00D9300F 


Explanation: The commit/abort secondary FRR (DSNRCAFR) 
invoked DB2 subsystem termination. This occurs only if func- 
tional recovery itself fails while processing a failure during 
must-complete processing for phase 2 of a commit-UR request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


[ — Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNRCAFR 


Ue ee End of Internal DB2 Information ook a fal 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error. The same is done for the secondary error 
before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump for both the original and the 
secondary error. 


Problem Determination: See the original error. 





00D93011 


Explanation: A subcomponent of DB2 invoked commit when 
the agent state was invalid for commit-UR invocation. 
Commit-UR was requested for an agent that was modifying 
data. Either commit-UR or abort-UR was already in process, or 
the recovery structure (URE) was damaged. 


[roe — Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNRUCO1 


Cee ee End of Internal DB2 information et 


System Action: Abnormal termination of the agent results, 
including backing out (abort-UR) of its activity to the previous 
point of consistency. This releases all locks held by the agent 
for its resources. 


Standard DB2 diagnostic information is recorded in 
SYS1.LOGREC, and an SVC dump is scheduled. Additional 
information, identified in the SDWA variable recording area by 
reason code '00D9CCCC', is added to the SDWA variable 
recording area (VRA). For information about finding the SDWA, 
refer to Section 5 of Diagnosis Guide and Reference. 


If the agent were in a must-complete state (in-commit2 or in- 
abort), the DB2 subsystem is also terminated with reason code 
'00D93001'. When the subsystem is next restarted, recover- 
able activity for this agent (such as an ensure-abort or ensure- 
commit UR) is handled to complete the commit or abort 
process. 


4-126 DB2 Messages and Codes 


System Programmer Response: This is a DB2 subsystem 
error. Collect the materials mentioned in the Problem Determi- 
nation section of this message. 


Problem Determination: Examine the SYS1.LOGREC data and 
the DB2 trace table in the dump to establish whether either 
commit-UR was invoked incorrecily or the control structure that 
reflects the state (ACEPROG, UREPROG) was damaged. 


00D93012 


Explanation: A subcomponent of DB2 invoked commit when 
the agent state was invalid for commit-UR invocation. 
Commit-UR was invoked for an agent that was only retrieving 
data. Either commit-UR or abort-UR was already in process, or 
the ACE progress state field was damaged. 


[rs Internal DB2 Information a | 


This abend reason code is issued by the following CSECT(s): 
DSNRUCO1 


Bea ee ee End of Internal DB2 Information re erren| 


System Action: Abnormal termination of the agent results, 
including backing out (abort-UR) of its activity to the previous 
point of consistency. This releases all locks held by the agent 
for its resources. 


Standard DB2 diagnostic information is recorded in 
SYS1.LOGREC, and an SVC dump is scheduled. Additional 
information, identified in the SDWA variable recording area by 
reason code '00D9CCCC', is added to the SDWA variable 
recording area. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for more information about the VRA. 


System Programmer Response: This is a DB2 subsystem 
error. Collect the materials mentioned in the Problem Determi- 
nation section of this message. 


Problem Determination: Examine the SYS1.L.OGREC data and 
the DB2 trace table in the dump to establish whether either 
commit-UR was invoked incorrectly or the control structure 
(ACEPROG) was damaged. 


00D93100 


Explanation: This reason code indicates that a DB2 allied 
agent does not need to participate in the Phase 2 (Continue 
Commit) call, because all required work has been accom- 
plished during the Phase 1 (Prepare) call. 


This reason code is generated by Recovery Manager when it is 
determined that a DB2 allied agent has not updated any DB2 
resource since its last commit processing occurred. 


| Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNRUCO1 


Peg secre End of Internal DB2 Information hese 


System Action: The "yes" vote is registered with the Commit 
coordinator. 


System Programmer Response: None should be required 
because this is not an error reason code. This reason code is 
used for communication between components of the DB2 sub- 
system. 


| 
| 


Problem Determination: This reason code is not indicative of 
an error. See System Programmer Response. 


00D94001 


Explanation: The commit/abort FRR (DSNRCAFR) invoked DB2 
subsystem termination, because an unrecoverable error was 
detected during must-complete processing for an abort-UR 
request. é 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


in ~~ Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNRCAFR, DSNRUAO2 


[ae ee End of Interna! DB2 Information eer! 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the reason code for the original 
error. 


OODS400F 


Explanation: The commit/abort FRR (DSNRCAFR) invoked DB2 
subsystem termination. This occurs only if functional recovery 
itself fails while processing a failure during must-complete 
processing for an abort-UR request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


‘ia ~ Internal DB2 information ~~ : | 


This reason code is issued by the following CSECT(s): 
DSNRCAFR 


[ee Peat tte End of Internal DB2 Information SES 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error. The same is done for the secondary error 
before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for both the original and the 
secondary error. 


Problem Determination: See the original error. 


00094011 


Explanation: A subcomponent of DB2 invoked abort at a point 
when the agent state is invalid for invoking the function that 
aborts units of recovery. Either abort-UR or commit-UR phase 2 
was already in process, or the agent structure was damaged. 


00D94001 — 00D95011 


[ ‘Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNRUAO1 


fet et ee End of Internal DB2 Information ee ee 


System Action: Abnormal termination of the agent results and, 
because the agent is in a must-complete state, the DB2 sub- 
system is terminated with reason code '00D94001'. When the 
DB2 subsystem is restarted, recoverable activity for this agent 
is handled to complete the commit or abort process. 


Standard DB2 diagnostic information is recorded in 
SYS1.LOGREC, and an SVC dump is scheduled. Additional 
information, identified in the SDWA variable recording area by 
reason code '00D9AAAA7', is added to the SDWA variable 
recording area. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for more information about the VRA. 


System Programmer Response: This is a DB2 subsystem 
error. Collect the materials mentioned in the Problem Determi- 
nation section of this message. 


Problem Determination: Examine the SYS1.LOGREC data and 
the DB2 trace table in the dump to establish whether 
commit-UR was invoked incorrectly or the contro! structure 
(ACEPROG, UREPROG) was damaged. 


00D95001 


Explanation: The recovery manager’s common FRR 
(DSNRCRFR) invoked DB2 subsystem termination, because an 
unrecoverable error was detected during checkpoint 
(DSNRCPRC) processing. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic information” on page 1-7. 


[ r ae Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNRCRFR, DSNRCPRC 


bee at End of Internal DB2 Information Jot ed 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the origina! error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00D95011 


Explanation: The recovery manager checkpoint (DSNRPBCW) 
FRR invoked DB2 subsystem termination, because an unrecov- 
erable error was detected while performing its checkpoint func- 
tions. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


DB2 Codes 4-127 


00D96001 — 00D96022 


[ vires : Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRPBCW 


Lets comes End of Internal DB2 Information pene ead 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00D96001 


Explanation: The recovery manager’s restart FRR invoked DB2 
subsystem termination, because an unrecoverable error was 
detected during the restart processor (DSNRRPRC) processing. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


= ~~ Internal DB2 Information 


This reason code is issued by the following CSECT(s): 


DSNRCRFR DSNRRPRC DSNRRAUB 
DSNRRCSL DSNRRCSR DSNRRHSR 
DSNRRHSL DSNRRPMU 


cere End of Internal DB2 Information ea eee 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00096011 


Explanation: The restart participation FRR invoked DB2 sub- 
system termination, because an unrecoverable error was 
detected while processing log records during restart. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


[ eS Internal DB2 Information ~ | 


This reason code is issued by the following CSECT(s): 
DSNRPBCS 


Dos Seer End of Internal DB2 Information eee 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 
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Operator Response: Print SYS1.LOGREC, correct the problem, 
and restart DB2. 


System Programmer Response: Obtain a copy ofthe 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00D96021 


Explanation: The DB2 subsystem was terminated during 
restart because a failure occurred while attempting to read the 


‘log forward MODE(DIRECT). It is accompanied by a recovery 
- log manager abend X'04E' with a reason code describing the 
‘Specific failure. 


Each time a portion of the log is skipped, a read direct is used 
to validate the beginning RBA of the portion that is read. 


This is a DB2 subsystem termination reason code. For further 


information, see “DB2 Diagnostic Information” on page 1-7. 


| - Internal DB2 Information . | 


This reason code is issued by the following CSECT(s): 
DSNRRHSR, DSNRRCSR 


Ls End of Interna! DB2 Information ____—_— 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 


_System Programmer Response: Obtain a copy of the 


SYS1.LOGREC and the SVC dump for the original error. If pos- 
sible, correct cause of original error and restart DB2. If you 
cannot correct the error, refer to Section 5 (Volume 2) of Admin- 


_istration Guide. 


00D96022 


Explanation: The restart FRR invoked abend, because, while 
reading the log forward during restart, the end-of-log was read 


‘ before ail recovery log scopes had been processed. It is fol- 


lowed by DB2 abnormal subsystem termination with the same 
reason code ('00D96022'). 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


a — Internal DB2 Information ~ a 


This reason code is issued by the following CSECT(s): 
DSNRRHSR 


. fe End of Internal DB2 information ee eee 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the abend before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery jog 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Notify your system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. If you 
cannot correct the error, refer to Section 5 (Volume 2) of Admin- 
istration Guide. 


Problem Determination: At the time of the abend, registers 2 
and 3 (as shown in the dump or in SYS1.LOGREC) contain the 
6-byte relative byte address (RBA) of the last log record that 
was read before end-of-log was encountered. 


00D96031 


Explanation: The restart FRR invoked DB2 subsystem termi- 
nation, because a failure occurred while attempting to read the 
log backward MODE(DIRECT). It is accompanied by a recovery 
log manager abend X'04E' with a reason code describing the 
specific failure. 


Each time a portion of the log is skipped, a read direct is used 
to validate the beginning RBA of the portion that is read. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


‘aa ~—— Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNRRAUB 


eee End of Internal DB2 Information ese 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Probiem Determination: See the accompanying abend reason 
code. 


00D96032 


Explanation: During restart, the end of the log was read before 
all the expected log ranges had been processed. The abend is 
accompanied by a DB2 abnormal subsystem termination with 
the same reason code (‘'00D96032'). 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic information” on page 1-7. 


00D96031 — 00D97011 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRRAUB 


[eiete SS End of Internal DB2 Information fen des all 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC. A 04E-D96032 SVC dump is 
requested. The DB2 subsystem is terminated with DSNVO86E 
message. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Use the MVS DISPLAY DUMP command to get the failure 
reason code from dump titles. 

4. Notify your system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. Deter- 
mine where the log went. Refer to Section 5 (Volume 2) of 
Administration Guide before restarting. 


Problem Determination: At the time of the abend, registers 2 
and 3 contain the 6-byte relative byte address (RBA) of the last 
log record that was read before end-of-log was encountered. 


00D97001 


Explanation: The failing agent was cancelled while waiting for 
the RECOVER-UR service to complete. 


i. internal DB2 Information ~ 7 | 


This abend reason code is issued by the following CSECT(s): 


‘DSNRRURS 


ee ee End of Internal DB2 Information Dee tet ad 


System Action: The RECOVER-UR function is completed. 
Abnormal termination of the requesting agent occurs. Standard 
DB2 diagnostic information is recorded in SYS1.LOGREC, and 
an SVC dump is requested. 


The condition that caused cancellation of the agent was instal- 
lation initiated (for example, a 'forced' termination of the DB2 
subsystem). 


00D97011 


Explanation: The DB2 subsystem was terminated during 
RECOVER-UR because an unrecoverable error was detected 
during RECOVER-UR (DSNRRUPR) recovery processing. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


[ ~ Internal DB2 Information ae 


This reason code is issued by the following CSECT(s): 
DSNRCRFR, DSNRRULC, DSNRRUPR 


[fore mete End of Internal DB2 Information See | 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested. 
DB2 subsystem terminates with a DSNVO86E messages and a 
return code of 00D97011. 


DB2 Codes 4-129 


00D97012 — 00D97031 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Determine the original error. 
If the error is log related, refer to Section 5 (Volume 2) of 
Administration Guide before restarting. 


Problem Determination: See the original error. 


00D97012 


Explanation: The RECOVER-UR request servicer (DSNRRURS) 
FRR invoked DB2 subsystem termination, because an unrecov- 
erable error was detected while attempting to recover a unit of 
recovery. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


a ~— Internal DB2 Information ~~ | 


This reason code is issued by the following CSECT(s): 
DSNRRURS 


ee End of Internal DB2 Information ree 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the original error. 


00D97021 


Explanation: The RECOVER-UR FRR invoked DB2 subsystem 
termination, because a failure occurred while attempting to 
read the log MODE(DIRECT) during forward processing. It is 
accompanied by a recovery log manager abend X'04E' witha 
reason code describing the specific failure. 


Each time a portion of the log is skipped, a read direct is used 
to validate the beginning RBA of the portion that is read. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


| Internal DB2 Information ~————_———— “| 


This reason code is issued by the following CSECT(s): 
DSNRRULC 


(tones End of Internal DB2 Information teste Sa dl 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 
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System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the accompanying abend reason 
code. 


00D97022 


Explanation: The RECOVER-UR invoked abend because end- 
of-log was reached before all ranges had been processed for 
forward recovery. This abend is accompanied by a DB2 
abnormal termination with the same reason code ('00D97022'). 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


| — Internal DB2 Information ~~ eer | 


This reason code is issued by the following CSECT(s): 
DSNRRULC 


———ers End of Internal DB2 Information of ase ol 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: At the time of the abend, registers 2 
and 3 contain the 6-byte relative byte address (RBA) of the fast 
log record that was read before end-of-log was encountered. 


00D97031 


Explanation: The RECOVER-UR FRR invoked DB2 subsystem 
termination, because a failure occurred during an attempt to 
read the log MODE(DIRECT) while reading the log backward. It 
is accompanied by a recovery log manager abend X'04E' with 
a reason code describing the specific failure. 


Each time a portion of the log is skipped, a read direct is used 
to validate the begin-scope RBA of the portion that is read. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


[ Internal DB2 Information ~———_————— 1 


This reason code is issued by the following CSECT(s): 
DSNRRULC 


| End of internal DB2 Information 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See recovery log manager abend 
reason code. 


00D97032 


Explanation: The RECOVER-UR invoked abend because end- 
of-log was reached before all ranges had been processed for 
backward recovery. This abend is accompanied by a DB2 
abnormal termination with the same reason code ('00D97032'). 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


f Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRRULC 


| eEnd of Internal pB2 information | 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: At the time of the abend, registers 2 
and 3 contain the 6-byte relative byte address (RBA) of the last 
log record that was read before end-of-log was encountered. 


00D98001 


Explanation: The recovery manager’s common FRR 
(DSNRCRFR) invoked DB2 subsystem termination, because an 
unrecoverable error was detected during indoubt-UR 
(DSNRRIPR DSNRRIRD DSNRRIUN DSNRIPMU) processing. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRCRFR 


a rs End of Internal DB2 Information eee 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


00D97032 — 00D98021 


Operator Response: Print SYS1.LOGREC, restart DB2. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Probiem Determination: See the original error. 


00D98011 


Explanation: The FRR for the resoived-indoubt-UR request 
servicer (DSNRIURS) invoked DB2 subsystem termination, 
because an unrecoverable error was detected processing a 
request. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRIURS 


Ti eat End of Internal DB2 Information Feat 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: Print SYS1.LOGREC, and restart DB2. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the accompanying abend reason 
code. 


00D98021 


Explanation: The resolved indoubt FRR invoked DB2 sub- 
system termination because of a failure while attempting to 
read the log MODE(DIRECT) during forward recovery. It is 
accompanied by a recovery log manager abend X'04E' witha 
reason code describing the specific failure. 


Each time a portion of the log is skipped, a read direct is used 
to validate the beginning RBA of the portion that is read. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


= : ~—~~—"_ Internal DB2 Information ~~ i 


This reason code is issued by the following CSECT(s): 
DSNRRIRD 


les esse ee, End of Internal DB2 Information eee et 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


DB2 Codes 4-131 


00D98022 — 00D99001 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the accompanying abend reason 
code. 


00D98022 


Explanation: Resolved indoubt invoked abend when end-of-log 
was reached before all ranges had been processed for forward 
recovery. This abend is accompanied by abnormal DB2 sub- 
system termination with the same reason code ('00D98022'). 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic information” on page 1-7. 


[ : ~ Internal DB2 Information a | 


This reason code is issued by the following CSECT(s): 
DSNRRIRD 


be eee se End of internal DB2 Information ae 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: At the time of the abend, registers 2 
and 3 contain the 6-byte relative byte address (RBA) of the last 
log record that was read before end-of-log was encountered. 


00D98031 


Explanation: The resolved indoubt FRR invoked DB2 sub- 
system termination, because a failure occurred during an 
attempt to read the log MODE(DIRECT) while reading the log 
backward. It is accompanied by a recovery log manager abend 
X'04E' with a reason code describing the specific failure. 


Each time a portion of the log is skipped, a read direct is used 
to validate the begin-scope RBA of the portion that is read. 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


a oe ~~ Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRRIUN 


| Ss Ena of internal DB2 Information | 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 
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Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. ; 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: See the accompanying abend reason 
code. 


00D98032 


Explanation: Resolved indoubt FRR invoked abend when end- 
of-log was reached before all ranges had been processed for 
backward recovery. This abend is accompanied by abnormal 
DB2 subsystem termination with the same reason code 
('00D98032'). 


This is a DB2 subsystem termination reason code. For further 
information, see “DB2 Diagnostic Information” on page 1-7. 


| Internal DB2 information ~~ =i 


This reason code is issued by the following CSECT(s): 
DSNRRIUN 


be ye End of Interna! DB2 Information pear ea 


System Action: Standard DB2 diagnostic information is 
recorded in SYS1.LOGREC, and an SVC dump is requested for 
the original error before DB2 subsystem termination is initiated. 


Operator Response: 


1. Run the Print Log Map utility to print content of both BSDSs. 

2. Print SYS1.LOGREC. 

3. Follow instructions for the accompanying recovery log 
manager error. Use the MVS DISPLAY DUMP command to 
get the failure reason code from dump titles. 

4. Start DB2 again. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump for the original error. 


Problem Determination: At the time of the abend, registers 2 
and 3 contain the 6-byte relative byte address (RBA) of the last 
log record that was read before end-of-log was encountered. 


00D99001 


Explanation: An attempt to read the CHKPTRBA failed to return 
a valid checkpoint record. This abend is issued after the 
DSNR015I error message is issued. 


System Action: Restart is abended. 
Operator Response: Inform the system programmer. 


System Programmer Response: Let Change Log Inventory 
select the checkpoint RBA when building the conditional restart 
record. If a specific checkpoint is desired, use DSN1LOGP to 
print out the checkpoint log records within a specified range. If 
manual selection of the checkpoint RBA is desired, use the 
Print Log Map utility to print the checkpoint queue. Print the 
checkpoint queue by using the CHKPTRBA keyword. 


Problem Determination: 


e¢ Print the checkpoint records within the desired range using 
DSN1LOGP. 

¢ Print the checkpoint queue using the Print Log Map utility. 

° Verify the checkpoint queue against the DSN1LOGP report. 

° If automatic checkpoint selection was used and the check- 
point was invalid, find the valid checkpoint RBA in the 
DSN1LOGP report. Use this checkpoint RBA in the CRCR 
using the CHKPTRBA keyword. 

© If an explicit checkpoint was specified and the checkpoint 
was invalid, let the Change Log Inventory automatically 
choose the checkpoint by not specifying a CHKPTRBA 
keyword. 


00D99002 


Explanation: Validation of the STARTRBA failed because either 
the end of the fog was reached, or a bad log record was 
encountered while attempting to find the first complete log 
record. 


System Action: Restart abends. 
Operator Response: Inform the system programmer. 


System Programmer Response: Check the console log for 
DSNJ (Log Manager) messages; these may indicate failures in 
the Log Manager processing, or may reveal additional useful 
information for diagnostic purposes. Use DSN1LOGP to find a 
safe STARTRBA to use for restart. If a STARTRBA is specified, 
the Recovery Manager will use it as a starting point. From the 
starting point, the Recovery Manager will attempt to find the 
beginning of a valid log record. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5:1, 
15. 


00D98003 


Explanation: CSRONLY was specified in the conditional restart 
record. Only the DB2 status phase of restart will complete. 


System Action: Restart abends. 


System Programmer Response: Use the Change Log Inventory 
to cancel the current conditional restart record or create a new 
conditional restart record. 


OODSAAAA 


Explanation: This reason code identifies additional data stored 
in the SOWA variable recording area following a failure during 
abort-UR. 


This reason code appears only in the SDWA variable recording 
area (VRA) and serves only to identify data (in addition to the 
standard DB2 diagnostic information that is stored in the 
SDWA). This reason code is the first data item of the standard 
information. As such, it always appears in the VRA of an SDWA 
for a primary error completion/reason code. If no data is 
added, the reason code in the SDWA VRA is the same as that 
associated with the completion code. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRCAFR 


Ut ates End of Internal DB2 Information ee 


00D99002 — 00DSCCCC 


System Action: Five bytes of data preceded by code VRAHEX 
are stored following the EBCDIC string 
'RMC-COMMIT/ABORT'. 


Length Data 


1 byte Retry flags 

1 byte Retry id 

1 byte Notification RMID 

2bytes ACE progress state (ACEPROG) 


System Programmer Response: Use this information in con- 
junction with other information for the the primary failure. For 
information about finding the SDWA, refer to Section 5 of Diag- 
nosis Guide and Reference. 


0ODSBBBB 


Explanation: This reason code identifies additional data stored 
in the SDWA variable recording area following a failure during 
begin-UR. 


This reason code appears only in the SDWA variable recording 
area (VRA) and it serves only to identify data (in addition to the 
standard DB2 diagnostic information, stored in the SDWA). This 
reason code is the first data item of the standard information. 
As such, it always appears in the VRA of an SDWA for a primary 
error completion/reason code. If no data is added, the reason 
code in the SDWA VRA is the same as that associated with the 
completion code. 


| - Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNRUBO1 


cae Sones es End of Internal DB2 Information id 


System Action: The following data is stored preceded by code 
VRAHEX. 


Length Data 


4 Content of ACEURE 

4 URE address 

4 DSNWRCRD return code 
1 Retry flags 


System Programmer Response: Use this information with the 
instructions for the specific failure. For information about 
finding the SDWA, refer to Section 5 of Diagnosis Guide and 
Reference. 


ooDSCcCcc 


Explanation: This reason code identifies additional data stored 
in the SDWA variable recording area following a failure during 
commit-UR. 


This reason code appears only in the SDWA variable recording 
area (VRA) and serves only to identify data (in addition to the 
standard DB2 diagnostic information, stored in the SOWA). This 
reason code is the first data item of the standard information. 
As such, it always appears in the VRA of an SDWA for a primary 
error completion/reason code. . 


[ ~~~ Internal DB2 Information ey 


This reason code is issued by the following CSECT(s): 
DSNRCAFR 


Pe ee ees End of Internal DB2 Information ee 


DB2 Codes 4-133 


OODSEEEE — O0DSEEEE 


System Action: Five bytes of data preceded by code VRAHEX 
are stored following the EBCDIC string 
*RMG-COMMIT/ABORT'. 


Length Data 

1 byte Retry id 

1 byte Notification RMID 

1 byte ACE progress state (ACEPROG) 


1 bit In flight 

1 bit In-Commit1 

1 bit Indoubt 

1 bit In-Commit2 

1 bit End-Commit 
1 bit In-Abort 

1 bit End-Abort 

1 bit (Reserved) 


System Programmer Response: Use this information with the 
instructions for the specific failure. For information about 
finding the SDWA, refer to Section 5 of Diagnosis Guide and 
Reference. 
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OODSEEEE 


Explanation: This reason code identifies additional data stored 
in the SDWA variable recording area following a failure during 
end-UR. 


This reason code appears only in the SDWA variable recording 
area (VRA) and serves only to identify data (in addition to the 
standard DB2 diagnostic information, stored in the SDWA). This 
reason code is the first data item of the standard information. 
As such, it always appears in the VRA of an SDWA for a primary 
error completion/reason code. 


| een Meee Internal DB2 Information ~~~ | 


This reason code is issued by the following CSECT(s): 
DSNRUEO1 


lee, See End of internal DB2 Information Se Al 


System Action: The following data is stored preceded by code 
VRAHEX. 


Length Data 
4 URE address 
4 DSNWRCRD return code 


System Programmer Response: Use this information in con- 
junction with the information about the error completion code. 
For information about finding the SDWA, refer to Section 5 of 
Diagnosis Guide and Reference. 


00E20001 — 00E20005 





Storage Manager Reason Codes (X'E2') 


00E20001 


Explanation: The get variable storage function detected that 
input parameters passed by the invoker were invalid. 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


Lo End of Internal DB2 Information eee 


System Action: The invoker of DSNSGSTG is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB), which con- 
tains the input parameters. Register 7 contains the address of 
the caller’s saved register 14. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20002 


Explanation: The free variable storage function detected that 
input parameters passed by the invoker were invalid. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


a End of Internal DB2 Information | 


System Action: The invoker of DSNSFSTG is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB), which con- 
tains the input parameters. Register 7 contains the address of 
the caller’s saved register 14. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20003 


Explanation: in order to satisfy an unconditional request for 
storage, the get variable storage function needed to obtain 
storage (from GETMAIN) to expand a storage pool. However, 
GETMAIN indicated that sufficient storage in the private area 
was not available. 


| Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


ee ee End of Internal DB2 Information eee 


System Action: The invoker of DSNSGSTG is abended. 
Operator Response: Notify the system programmer. 
System Programmer Response: Increase region size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. Register 4 contains the address of the pool header 
block (PHB). Register 7 contains the address of the caller’s 
saved register 14. The trace information contains the 
requested amount of storage. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20004 


Explanation: !n order to satisfy an unconditional request for 
storage, the get variable storage function needed to obtain 
additional storage (from GETMAIN) to expand a storage pool. 
However, the pool attributes defined at the time the pool was 
created indicated that the pool was already at maximum size. 


~— Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


[eter Sees End of Internal DB2 Information potest 


System Action: The invoker of DSNSGSTG is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB). Register 7 
contains the address of the caller’s saved register 14. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20005 


Explanation: The free variable storage function detected that 
the address of a block being freed was invalid. That is, it did 
not lie within an existing storage pool. 


DB2 Codes 4-135 


00E20006 — 00E2000A 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


eee ee End of internal DB2 Information ate eo etl 


System Action: The invoker of DSNSFSTG is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the poo! header block (PHB). Register 7 
contains the address of the caller’s saved register 14. Register 
11 contains the address of the invalid block to be freed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20006 


Explanation: The free variable storage function detected that 
the block being freed was not allocated. That is, it was already 
free. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


re eesti End of Internal DB2 Information Se 


System Action: The invoker of DSNSFSTG is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB). Register 7 
contains the address of the caller’s saved register 14. Register 
11 contains the address of the free block. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20007 


Explanation: The get variable storage pool function detected 
that the input parameter list passed by the invoker was invalid. 


—-= ~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSVPL 


Weta Se Aer e End of Internal DB2 Information teens Se 


System Action: The invoker of DSNSGPOL is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 
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Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation contains the address of the invalid parameter list. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20008 


Explanation: The free variable storage pool function detected 
that the input parameter (PHB—pool header block) did not rep- 
resent an existing pool. 


[3 Internal DB2 Information ~~ aa 


This abend reason code is issued by the following CSECT(s): 
DSNSVPL 


ee End of Internal DB2 Information eae Soest 


System Action: The invoker of DSNSFPOL is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation contains the address of the invalid PHB (pool header 
block). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20009 


Explanation: The get fixed block(s) function detected that input 
parameters passed by the invoker were invalid. 


~ Internal DB2 Information —~——__————S— | 


This abend reason code is issued by the following CSECT(s): 
DSNSFBK 


[ee Ae! End of internal DB2 Information pre eee 


System Action: The invoker of DSNSGBLK is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB). Register 7 
contains the address of the caller’s saved register 14. The 
invalid parameters are contained in the pool header block 
(PHB) and the trace information. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2000A 


Explanation: The get tracked storage function requested 
storage from the DSNSGETM function for a tracking element in 
order to track the storage to be returned to the invoker. 
However, storage for the tracking element was unavailable. 
The invoker’s request was unconditional. 


[ha 7 Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSGMN 


Dee gee End of Internal DB2 Information S| 


System Action: The invoker of DSNSGETM is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2000B 


Explanation: !n order to satisfy an unconditional request, the 
get fixed block(s) function needed to obtain additional storage 
to expand a storage pool. However, GETMAIN indicated that 
insufficient storage existed in the private area. 


[ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSFBK 


LS seEnd of Internal 082 Information 


System Action: The invoker of DSNSGBLK is abended. 
Operator Response: Notify the system programmer. 
System Programmer Response: Increase region size. 


Problem Determination: Diagnostic.information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. Register 4 contains the address of the pool header 
block (PHB). Register 7 contains the address of the caller’s 
saved register 14. The trace information contains the number 
of blocks requested. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2000C 


Explanation: In order to satisfy an unconditional request, the 
get fixed block(s) function needed to obtain additional storage 
to expand a storage pool. However, the pool attributes defined 
at the time the pool was created indicated that the poo! was 
already at maximum size. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSFBK 


[eget ee End of Internal DB2 Information eT | 


System Action: The invoker of DSNSGBLK is abended. 


Operator Response: Notify the system programmer. 


00E2000B — 00E2000E 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB). Register 7 
contains the address of the caller’s saved register 14. The 
trace information contains the number of blocks requested. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2000D 


Explanation: The free fixed block function detected that either 
the address of a block being freed (the only block or a block on 
a chain of blocks) was invalid or the block did not lie within an 

existing storage pool. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSFBK 


a ee End of Internal DB2 Information ee 


System Action: The invoker of DSNSFBLK is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 7 con- 
tains the address of the caller’s saved register 14. Register 11 
contains the address of the invalid block to be freed. 


Collect the following diagnostic items listed in Appendix 8B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2000E 


Explanation: The get fixed block(s)/free fixed block function 
detected that a segment of storage within the pool (against 
which the request was directed) was invalid or contained an 
invalid 'free chain' of free blocks in the segment. 


oo ~~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSFBK 


re End of Internal DB2 Information | 


System Action: The invoker of DSNSGBLK/DSNSFBLK is 
abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag-. 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB). Register 7 
contains the address of the caller’s saved register 14. Register 
11 contains the address of the block to be freed if freeing a 
fixed block. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


DB2 Codes 4-137 


00E2000F — 00E20013 


O00E2000F 


Explanation: The free fixed block(s) function detected that the 
only block, or the one biock on the chain of biocks, being freed 
did not represent an allocated block; that is, it was already free. 


| Internal DB2 Information ame | 


This abend reason code is issued by the following CSECT(s): 
DSNSFBK 


| SS sEEnd of Internal DB2 Information ___——_— 


System Action: The invoker of DSNSFBLK is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB). Register 7 
contains the address of the caller’s saved register 14. Register 
11 contains the address of the free block. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20010 


Explanation: The get fixed-block pool function detected an 
invalid input parameter list. 


[ Far ~~ Internal DB2 Information a 


This abend reason code is issued by the following CSECT(s): 
DSNSFPL 


eee End of Internal DB2 Information ee 


System Action: The invoker of DSNSGPOL is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation contains the address of the invalid parameter list. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20011 


Explanation: The free fixed-block pool function detected that 
the input parameter either was not a valid pool header block 
(PHB), or it did not represent an existing pool. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSFPL 


Recent ete End of Internal DB2 Information Se Fee 
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System Action: The invoker of DSNSFPOL is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation has the address of the pool header block (PHB). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20012 


Explanation: The get tracked storage from the GETMAIN func- 
tion detected an invalid parameter list passed by its invoker. 


[ Internal DB2 Information ~——_——S— | 


This abend reason code is issued by the following CSECT(s): 
DSNSGMN 


(ieee eed End of Internal DB2 information te Sees dl 


System Action: The invoker of DSNSGETM is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation has the address of the invalid parameter list. 


Collect the following diagnostic items listed in Appendix B, 
“Probiem Determination” on page X-5: 1, 2, 3, 5. 


00E20013 


Explanation: The get tracked storage from GETMAIN function 
was unable to obtain sufficient storage in private area to satisfy 
an unconditional request. 


| Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNSGMN 


bees End of Internal DB2 Information ae 


System Action: The invoker of DSNSGETM is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 
System Programmer Response: Increase region size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. The trace information has the address of the param- 
eter list. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20014 


Explanation: The free tracked storage function detected that 
the area requested to be freed was not valid. Either the 
address did not represent storage currently allocated (via the 
DSNSGETM function), or the storage class passed as input to 
DSNSFREM did not match the class assigned to the storage by 
DSNSGETM. 


f | — {Internal DB2 Information ~—— ——— 


This abend reason code is issued by the following CSECT(s): 
DSNSGMN 


ee End of Internal DB2 information eee | 


System Action: The invoker of DSNSFREM is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation has the address of the storage and the storage class. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20015 


Explanation: The allocate stack function, which is always 
unconditional, requested storage from GETMAIN to obtain a 
stack segment. GETMAIN indicated that 8K bytes of private 
area storage in subpool 229 was not available. 


Internal DB2 Information ~"—_———<‘<;7 ] | 


This abend reason code is issued by the following CSECT(s): 
DSNSVSTK 


ae End of Internal DB2 Information po eee 


System Action: The invoker of DSNSASTK is abended. 
Operator Response: Notify the system programmer. 
System Programmer Response: Increase region size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. There is prob- 
ably a shortage of private area storage in the address space in 
which the failure occurred. Register 2 contains the ASID, in 
hexadecimal, of the private area to be printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20016 


Explanation: The get stack storage function, in order to satisfy 
an unconditional! request for stack storage, requested storage 
from GETMAIN. However, GETMAIN indicated that sufficient 
storage in subpool! 229 was not available. 


00E20014 — 00E20018 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSVSTK 


[eae End of Internal DB2 Information ie 


System Action: The invoker of DSNSGSTK is abended. 
Operator Response: Notify the system programmer. 
System Programmer Response: Increase region size. 


Probiem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20017 


Explanation: The free stack storage function detected that the 
address of the area to be freed did not lie within allocated 
storage in the stack indicated by the requestor. 


| Internal DB2 information ~——————S = 


This abend reason code is issued by the following CSECT(s): 
DSNSTACK 


{| End of Internal DB2 Information _ 


System Action: The invoker of DSNSFSTK is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20018 


Explanation: The get stack storage function detected that the 
amount of storage requested by the invoker was less than or 
equal to zero. 


i Internal DB2 Information ~~ _ OES 


This abend reason code is issued by the following CSECT(s): 


DSNB1CHK DSNB1CPP DSNB1CPS 
DSNB1CST DSNB1OPP DSNB10PS 
DSNB10ST DSNB1RRR DSNB1RTR 
DSNB1SWS DSNB1SWU DSNBSCOM 
DSNFGENM DSNIBHUN DSNICINV 
DSNIDLEO DSNILGBW DSNILREP 
DSNIREPR DSNIRWSL DSNISEL 
DSNISELK DSNISRTI DSNISVPT 
DSNITDLE DSNJW101 DSNKCHNP 
DSNKDLET DSNKDLEV DSNKDLPG 
DSNKISRT DSNKLFIV DSNKMSP1 
DSNKMSV1 DSNKNLDL DSNKRDST 


DB2 Codes 


4-139 


00E20019 — 00E2001D 


DSNKREPL DSNVCONN DSNVDISC 
DSNVEUS2 DSNVIALC DSNVRMEL 
' DSNVSTAI DSNWTRAC = DSNXA02 
DSNXICIX DSNXICX2 DSNXOGC 
DSNXOGP DSNXOLV DSNXOOP 
DSNXOVD DSNXO1S DSN3CT30 
DSN3ID50 DSN3SI30 DSN9SCNF 


a End of Internal DB2 Information Goh | 


System Action: The invoker of DSNSGSTK is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20019 


Explanation: The purge pool function detected that input 
parameters passed by the invoker were invalid. 


| ~~ Internal DB2 Information ae 


This abend reason code is issued by the following CSECT(s): 
DSNSPOWN 


Ae eee End of Internal DB2 Information eee | 


System Action: The invoker of DSNSPPOL is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation contains the input parameters. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


OOE2001A 


Explanation: ESTAE recovery can not be established, because 
either an unexpected error occurred, or SCB is not available. 


[ee ee Internal DB2 Information ~~ 


This abend reason code is issued by the following CSECT(s): 
DSNSCON 


ess eee End of Internal DB2 Information her Se 


System Action: The invoker of DSNSCON is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 15 con- 
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tains the return code from DSN3EST0O; this is the MVS ESTAE 
return code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2001B 


Explanation: The SETLOCK OBTAIN function issued a nonzero 
return code. 


| ~ : Internal DB2 Information | 


This abend reason code is issued by the fotlowing CSECT(s): 


DSNSCON2 DSNSCTL DSNSFBK 
DSNSFPL DSNSGMN DSNSHDWN 
DSNSINTM DSNSTERM DSNSVBK 
DSNSVPL DSNSVSTK 


—— ar End of Internal DB2 Information Gee ee 


System Action: The invoker of storage manager functions is 
abnormally terminated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2001C 


Explanation: The purge stack function detected that one of the 
SKBs (stack block) is not valid and the SKB chain is possibly 
damaged. 


i internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSPURS 


be eee tes End of Internal DB2 Information re 


System Action: The SKB chain is repaired and processing con- 
tinues. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation contains the address of the EB for which the stack seg- 
ments are to be purged. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2001D 


Explanation: Either GPVT (global pool anchor) or LPVT (local 
pool anchor) is damaged, and no storage managed by storage 
manager can be accessed. 


F Internal DB2 Information ~~ ae 


This abend reason code is issued by the following CSECT(s): 
DSNSRSUP 


eo End of internal DB2 Information eo | 


System Action: The DB2 subsystem is abended. In some 
cases, the FRR is established by the caller of the storage 
manager (SM) subcomponent. When this is the case, the SVC 
dump is requested by the caller. When this is not the case, the 
SM requests the SVC dump. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: A DB2 dump is requested, but in some 
cases the dump request is made by the caller of storage 
manager, rather than by storage manager itself. Register 6 
contains the address of the EB. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2001E 


Explanation: The get stack storage function detected that two 
asynchronous (unrelated) agents use the same stack storage. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSVSTK 


Desheoae ee End of Internal DB2 Information es 


System Action: The invoker of DSNSGSTK is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the address of the stack segment (SKB). Register 6 con- 
tains the address of the EB. In the event of an ABEND, 
DSNTFRCV saves information in the VRA of the SDWA. For 
information about VRA data and finding the SDWA, refer to 
Section 5 of Diagnosis Guide and Reference. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2001F 


Explanation: !n order to satisfy an unconditional request for 
storage, the get variable storage function needed to obtain 
storage (from GETMAIN) to expand a storage pool. However, 
GETMAIN indicated that sufficient storage in common service 
area (CSA) to expand the pool was not available. 


| —————— internal DB2 Information ° Te ae | 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


Dee Bates End of Internal DB2 Information be ee Sea ate 


OOE2001E — 00E20021 


System Action: The invoker of DSNSGSTG is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Increase common service 
area (CSA) size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The common 
service area (CSA) portion of the dump should be printed. Reg- 
ister 4 contains the address of the pool header block (PHB). 
Register 7 contains the address of the caller’s saved register 
14. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20020 


Explanation: The get variable pool function needed to obtain 
storage (from GETMAIN) to create pool header block (PHB) to 
represent the pool, but GETMAIN indicated that sufficient 
storage in private area was not available. 


Internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNSVPL 


[eee ene End of Internal DB2 Information _ 


System Action: The invoker of DSNSGPOL is abended. 
Operator Response: Notify the system programmer. 
System Programmer Response: Increase region size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20021 


Explanation: The get variable pool function needed to obtain 
storage (from GETMAIN) to create pool header biock (PHB) to 
represent the pool, but GETMAIN indicated that sufficient 
storage in common service area (CSA) was not available. 


| Internal DB2 Information Ay a el 


This abend reason code is issued by the following CSECT(s): 
DSNSVPL 


lo ate End of Internal DB2 Information eee) 


System Action: The invoker of DSNSGPOL is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Increase common service 
area (CSA) size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The common 
service area (CSA) portion of the dump should be printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


DB2 Codes 4-141 


00E20022.— 00E20026 


00E20022 


Explanation: In order to satisfy an unconditional request, the 
get fixed block(s) function needed to obtain additional storage 
to expand a storage pool. However, GETMAIN indicated that 
sufficient storage in common service area (CSA) was not avail- 
able. 


| Internal DB2 Information are | 


This abend reason code is issued by the following CSECT(s): 
DSNSFBK 


reece eee End of Internal DB2 Information ete ee 


System Action: The invoker of DSNSGBLK is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Increase common service 
area (CSA) size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 4 con- 
tains the address of the pool header block (PHB). Register 7 
contains the address of the saved caller’s register 14. The 
common service area (CSA) portion of the dump should be 
printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20023 


_Explanation: The get fixed pool function needed to obtain 
storage (from GETMAIN) to create poo! header block (PHB) to 
represent the pool, but GETMAIN indicated that sufficient 
storage in private area was not available. 


| ; Internal DB2 Information iS | 


This abend reason code is issued by the following CSECT(s): 
DSNSFPL 


leaner cea 2 tes End of Internal DB2 Information | 


System Action: The invoker of DSNSGPOL is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 
System Programmer Response: Increase region size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 2 con- 
tains the ASID, in hexadecimal, of the private area to be 
printed. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20024 


Explanation: To create a pool header block (PHB) that repres- 
ents the pool, the get fixed pool function requested storage 
from GETMAIN. However, GETMAIN indicated that insufficient 
storage existed in the common service area (CSA) to satisfy the 
request. 
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| _— Internal DB2 Information ~~ ——_— ae: 


This abend reason code is issued by the following CSECT(s): 
DSNSFPL 


se a eee End of Internal DB2 Information rer | 


System Action: The invoker of DSNSGPOL is abnormally termi- 
nated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Increase common service 
area (CSA) size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The common 
service area (CSA) portion of the dump should be printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20025 


Explanation: The get tracked storage from GETMAIN function 
was unable to obtain sufficient storage in common service area 
(CSA) to satisfy an unconditional request. 


| : Internal DB2 Information ~ ari || 


This abend reason code is issued by the fetlowing CSECT(s): 
DSNSGMN 


en End of Internal DB2 Information oc | 


System Action: The invoker of DSNSGETM is abended. 


System Programmer Response: increase common service 
area (CSA) size. 


Operator Response: Notify the system programmer. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. The trace infor- 
mation has the address of the parameter list. The common 
service area (CSA) portion of the dump should be printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20026 


Explanation: Either the allocate stack storage function or the 
get stack storage function was unable to obtain 4K bytes of 
private area storage in subpool 229 for an all-segment table in 
which a record (representing a stack storage segment) was to 
be inserted. 


7 ; Internal DB2 Information ~~. © 


This abend reason code is issued by the following CSECT(s): 
DSNSVSTK 


Pigees —oepe e End of Internal DB2 Information _ 


System Action: The invoker of the function is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Increase region size. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. There is prob- 
ably a shortage of private area storage in the address space in 
which the failure occurred. Register 2 contains the ASID, in 
hexadecimal, of the private area to be printed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E20027 


Explanation: The free variable storage function detected that 
unallocated storage in the block being freed has been modified. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


en End of Internal DB2 Information eee 


System Action: The invoker of DSNSFSTG is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. 


The following general purpose registers (GPRs) contain the 
indicated diagnostic information: 


GPR Content 


4 address of the pool header block (PHB) 
7 address of the caller’s saved register 14 
11 address of the block to be freed 


The block to be freed includes two parts: a four word header of 
control information and the block itself. The second word in the 
header (offset of 4) is the length of the block. 


The third word in the header (offset of 8) is the length of the 
biock. The block is made up of two parts: allocated storage and 
two words of unallocated storage. 


00E20028 


Explanation: Either the get stack, deallocate stack or release 
stack storage function detected that an SKB was invalid or was 
not represented accurately in the all-segment table. 


[ ~ Internal DB2 Information ~ tot eo i 


This abend reason code is issued by the following CSECT(s): 
DSNSVSTK, DSNSTACK 


or. End of Internal. DB2 Information ae 


System Action: The invoker is abended. 
Operator Response: Notify the system programmer. 


‘System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 7 con- 
tains the address of the stack segment (SKB). 


00E20027 — 00E2002A 


00E20029 


Explanation: The free variable storage function detected that 
although the address of the block being freed was within the 
specified storage pool it was not the address of the beginning of 
a variable block. 


‘ae ‘ Internal DB2 Information er a ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNSVBK 


Rs oe End of Internal DB2 Information eee 


System Action: The invoker of DSNSFSTG is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. 


The following general purpose registers (GPRs) contain the 
indicated diagnostic information: 


GPR Content 


4 address of the poo! header block (PHB) 
7 address of the caller’s saved register 14 
11 address of the invalid block to be freed 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


00E2002A 


Explanation: The SMC Recovery Stack Management function 
detected that the number of allowed entries in the SMC 
Recovery Stack has been exceeded, or the structure has been 
incorrectly modified. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNSCTL DSNSFBK DSNSRSUP 
DSNSTACK DSNSVBK DSNSVSTK 


eee End of Internal DB2 Information ae ae cee 


System Action: The invoker is abended. 
User Response: None required. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Diagnostic information is recorded in 
SYS1.LOGREC, and a DB2 dump is requested. Register 6 con- 
tains the address of the current execution block (EB). This EB 
has a pointer to the current head stack block (SKB) that is 
encountering the problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


DB2 Codes 4-143 


00E2002B — 00E2002B 


00E2002B 


Explanation: This abend code is used to force percolation in 
the case when an abend is encountered while in Storage 
Manager code and the Storage Manager has been called 
recursively. 
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~~ Internal DB2 Information = 7 


This abend reason code is issued by the following CSECT(s): 


DSNSCTL DSNSFBK DSNSRSUP 
DSNSTACK DSNSVBK DSNSVSTK 


ee End of internal DB2 Information _ 


Problem Determination: Refer to the originating abend code. 


00E30001 — 00E30004 





Service Controller Reason Codes (X'E3') 


00E30001 


Explanation: A service controller internal inconsistency has 
been encountered. This is probably a DB2 subsystem error. 


c ~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 


DSNTAAL DSNTBAB OSNTBAP1 
DSNTBCM1 DSNTBFR DSNTBRB 
DSNTLBAC DSNTLCAU DSNTLDU 
DSNTLIDE DSNTSFST DSNTSGST 
DSNTSINI DSNTCGET DSNTCSTR 
DSNTDINQ DSNTLSUS 


ee End of Internal DB2 Information ee | 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The execution unit is abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: The service controller has detected 
an internal inconsistency. The problem can be determined by 
analyzing the CSECT involved in the abend. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30002 


Explanation: DSNTSTR2 loaded an out-of-date system param- 
eter CSECT DSN6SPRM. This error occurs if code maintenance 
has been applied and CSECT DSN6SPRM contained in the load 
module specified in the 'PARM=' parameter of the -START 
DB2 command has been reassembled. Message DSNT105I is 
also produced as a result of this error. 


[ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


ee ee es End of Internal DB2 Information eee 


System Action: DB2 is terminated with abend code '04F'. 
Operator Response: Notify the system programmer. 


System Programmer Response: Reassemble DSN6SPRM, and 
relink-edit the specified load module. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9. 


00E30003 


Explanation: An error was returned from a data manager 
restore operation. This abend is issued to ensure that changes 
made to the catalog by a failing BIND function are backed out. 


” ~~ Internal DB2 Information OY 


This abend reason code is issued by the following CSECT(s): 
DSNTBAB DSNTBCM1 DSNTBRB 


ee End of Internal DB2 Information es gta 


System Action: The BIND function is abended. All effects of 
the BIND operation are rolled back. A record is written to 
SYS1.LOGREC, and an SVC dump is requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: The service controtler code, using the 
data manager restore function, has detected an error while 
trying to undo the results of a BIND operation. The data 
manager return and reason code encountered can be found in 
the CTDMRETC and CTSIRCOD fields of the cursor table 
pointed to by register 7 in the SDWA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30004 


Explanation: This abend is issued by the service controller 
initialization module whenever an error return code is received 
from a database services subcomponent participating in the 
DB2 startup process. This abend ensures that DB2 is termi- 
nated. 


[ Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNTSTRT 


ie See End of Internal DB2 Information eee 


System Action: The database services shutdown process is 
initiated after an SVC dump is requested, and a record is 
written to the SYS1.LOGREC data set. DB2 is abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures and for information about dump analysis and 
service aids. 


Problem Determination: A list of all database services. sub- 
components whose initialization process has been completed 
may be obtained from the SVC dump requested by this abend. 
Register 2 in the SDWA points to a structure that contains the 
following diagnostic information: 


aa DB2 Codes 4-145 


00E30005 — 00E3000A 


0 (0) Module qualifier that identifies the area within 
DSNTSTRT at which the error was detected. The 
qualifier should be: 

A (10) Error found upon return from the SCC 
startup initialization process 

B (11) Error found upon return from the SCC 
IRLM identify process 


C (12) Error found upon return from the buffer 
manager initialization process 

D (13) Error found upon return from the data 
manager initialization process 

E (14) Error found upon return from the data 


space manager initialization process 
F (15) Error found upon return from the RDS 
initialization process 


2 (2) Error return code from the invoked subcomponent 
4 (4) Error reason code from the invoked subcomponent 
8 (8) Pointer to a structure containing a character string 


SSCM followed by a 32-bit map representing the fol- 
lowing information: 


Bit 0 1 if DB2 has successfully ‘signed on' to 
IRLM 

Bit 1 1 if the buffer manager subcomponent 
initialization process is completed 

Bit 2 1 if the data manager subcomponent 
initialization process is completed 

Bit 3 1 if the data space manager subcompo- 
nent initialization process is completed 

Bit 4 Not used 

Bit 5 1 if the RDS subcomponent initialization 
process is completed 

Bit 6 Not applicable 

Bit 7 1 if the SCC initialization process is com- 
pleted 


Bit 7 — 31 Not used 
C (12) Pointer to invoked subcomponent’s RMFT. 


From this information the appropriate subcomponent’s startup 
process may be identified. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30005 


Explanation: A service task could not be created during the 
database services initialization process. This is probably a DB2 
error. 


ft = : : Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNTSTRT 


eee End of Internal DB2 Information bie eae reel 
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System Action: A record is written to SYS1.L.OGREC, and an 
SVC dump is requested. DB2 is abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is possibly a DB2 internal 
error. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis 
and service aids. 


Problem Determination: Register 2 in the SDWA points toa 
structure that contains the following diagnostic information: 


0 (0) Should equal X'3' 

2 (2) Return code from the service task creation function 
of the agent services manager (ASM) subcomponent 

4 (4) Abend reason code from the service task creation 
function of the agent services manager (ASM) sub- 
component 

8 (8) Not used 


C (12) Not used 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30008 


Explanation: DSNTSTR2 loaded an incorrect version of the 
system parameter CSECT DSN6SPRM while DB2 was executing. 
Message DSNT103I is generated before the abend occurs. 


| Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


feces eae te End of Internal DB2 Information eee 


System Action: DB2 is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Restart DB2 with a -START 
DB2 PARM= command, where the parameter block that follows 
the 'PARM= ' parameter specifies an MVS/XA version of the 
DB2 subsystem parameters. . 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9. 


00E3000A 


Explanation: A bad recovery element was detected by the 
database services standard ESTAE and FRR recovery routines. 
This is probably a DB2 subsystem error. 


e— oe internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNB1CFC DSNB1CMS DSNB1iCST 
DSNB10ST DSNBSCOM DSNB5RAP 
DSNGESLC DSNIARPL DSNIBCUR 
DSNIBHIS DSNIBRES DSNIBRTO 
DSNIDDBD DSNIDPRO DSNIECUR 
DSNILABR DSNILCUR DSNILDBP 
DSNILHIS DSNPAMS1 DSNTAAL 
DSNTABA DSNTAC1 DSNTAC2 
DSNTAOL DSNTAEA DSNTANU 

.DSNTBAB DSNTBCM DSNTDMST 
DSNTDSTP DSNTRCKP DSNTRSTE 
DSNTSTOP DSNTSTRT DSNTXACT 
DSNTXSTB DSNUADP2 DSNUAHR2 
DSNUGRAR DSNXACKB DSNXACKP 
DSNXARVB DSNXERD 


[ End of Internal DB2 Information Sere 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The execution unit is abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: This error is detected when a module 
invokes the macro DSNTSFRR to disconnect a functional 
recovery element (FRE) from a functional recovery chain to 
which it is not connected. The name of the module passing the 
invalid FRE is the module issuing the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E3000B 


Explanation: The database services section (DSN6SPRM) in 
the DB2 initialization parameter module (DSNZPARM) does not 
exist. 


| — {Internal DB2 Information ~~ eS 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


leet End of Internal DB2 Information eae 


System Action: A record is written to SYS1.L.OGREC, and an 
SVC dump is requested. DB2 is abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an installa- 
tion error.. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis 
and service aids. 


00E3000B — 00E3000D 


Problem Determination: Register 2 in the SDWA points to a 
structure that contains the following diagnostic information: 


0 (0) Should equal X'1' 

2 (2) Return code from the get descriptor function of the 
system parameter manager (SPM) subcomponent of 
DB2 

4 (4) Not applicable 

8 (8) Not applicable 


C (12) Not applicable 


First, ensure that DSNZPARM was installed correctly. Then, 
using the return code from SPM, determine why the descriptor 
is not available. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 9. 


00E3000C 


Explanation: A database services TCB service task that cannot 
be reinstated has been abnormally terminated. Entries in 
SYS1.LOGREC that precede this entry indicate the source of the 
error. 


| Internal DB2 Information ~ SS 1 


This abend reason code is issued by the following CSECT(s): 
DSNTSREI 


Meant End of Interna! DB2 Information eed ee 


System Action: The executing unit is abended. A record is 
written to SYS1.LOGREC. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC, and determine the cause of the problem from 
the information that precedes this entry. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5. 


00E3000D 


Explanation: A failure occurred and was detected while an 
ESTAE functional recovery was being established. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNBICST DSNBIOST DSNIDDBD 
DSNIDPRO DSNILDBP DSNTBAP 
DSNTDMST DSNTSTOP DSNTSTRT 


eee End of Internal DB2 Information ot | 


System Action: The executing unit is abended. A record is 
written to SYS1.LOGREC. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC, and determine the cause of the probiem from 
the information that precedes this entry. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5. 


DB2 Codes 4-147 


OOE3S000E — 00E30011 


O00ESO00E 


Explanation: The execution unit supporting the database ser- 
vices checkpoint process has abended. The CSECT involved in 
the abend writes a record to SYS1.LOGREC and requests an 
SVG dump. 


Pee ey ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTRCKP 


{ End of Internal DB2 Information pected 


System Action: DB2 is abended. A record is written to 
SYS1.LOGREC. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC, and determine the cause of the problem from 
the information that precedes this entry. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00E3000F 


Explanation: The database services functional recovery load 
module, DSNTF, has an unrecognizable eniry point. 


es ae Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNTSTRT 


the dot End of Internal DB2 Information wea feseedl 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abnormally terminated. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an installa- 
tion error. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis 
and service aids. 


Problem Determination: Register 2 in the SDWA points to a 
structure that contains the following diagnostic information: 


0 (0) Should equal X'4' 
2 (2) Not applicable 
4 (4) Not applicable 
8 (8) Not applicable 


C (12) Not applicable 


The abend is generated whenever the DB2 load module 
DSNTFEPL is not link-edited with a load module entry point 
name of DSNTF. To correct this, link-edit DSNTFEPL again with 
the correct entry point name. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5. 


4-148 DB2 Messages and Codes 


00E30010 


Explanation: The database services initialization process 
could not read the DB2 bootstrap data set (BSDS). 


> cae aa Internal DB2 Information > | 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


an End of Internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abnormally terminated. 


Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an installa- 
tion error. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis 
and service aids. 


Problem Determination: This error can usually be traced to a 
VSAM error occurring while reading the BSDS. Before exam- 
ining the dump, examine the operator console log and SYSLOG 
to determine if VSAM has encountered any errors on the BSDS. 


Register 2 in the SDWA points to a structure that contains the 
following diagnostic information: 


0 (0) Should equal X'2' 

2 (2) Return code from a BSDS read request function of 
the recovery log manager (RLM) subcomponent 

4 (4) Abend reason code from a BSDS read request func- 
tion of the recovery log manager (RLM) subcompo- 
nent 

8 (8) Not applicable 


C (12) Not applicable 


Collect the following diagnostic items.listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5, 15. 


00E30011 


Explanation: Either the maximum number of concurrent table 
spaces is less than or equal to zero, or the DSN6SPRM is 
invalid. 


TE Internal DB2 Information sae | 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


| End of Internal DB2 Information _____—_—| 


System Action: DB2 is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: /f the maximum number of 
concurrent table spaces is less than or equal to zero, specify a 
valid value using either the DSMAX parameter in the 
DSN6SPRM assembler macro of the DSNTIJUZ job stream, or 
update the main storage sizes via the installation update 
panels. All other parameters contained in this version of the 
CSECT must also be specified again. Then do one of the fol- 
lowing: 


¢ Resubmit installation job DSNTIJUZ with the link-edit SYSIN 
file NAME parameter matching the -START DB2 'PARM=' 
parameter, or 


¢ Reassemble DSN6SPRM and relink-edit DSNZPARM by 
resubmiiting installation job DSNTIJUZ. The link-edit SYSIN 
file NAME parameter must match the -START DB2 
‘PARM=' parameter. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


00E30013 


Explanation: The value specified in the DSN6SYSP CSECT to 
define reserve storage is either negative or zero. 


ies Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


a End of Internal DB2 Information pn) 


System Action: DB2 is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Reassembie DSN6SPRM and 
relink-edit the DSNZPARM load module. This is done by resub- 
mitting the installation job stream, DSNTIJUZ, that built the load 
module named in the -START DB2 command 'PARM=' param- 
eter. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


00E30014 


Explanation: The value specified in the DSN6SYSP CSECT to 
define reserve storage for a 'must complete' process is either 
negative or 0. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


a End of Internal DB2 Information ee eee, 


System Action: DB2 is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Reassembie DSN6SPRM and 
relink-edit the DSNZPARM load module. This is done by resub- 
mitting the installation job stream, DSNTIJUZ, that built the load 
module named in the -START DB2 command 'PARM=' 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


00E30015 


Explanation: The value specified in the DSN6SYSP CSECT to 
define reserve storage for a 'short on storage' condition is 
either negative or 0. 


00E30013 — 00E30017 


i = internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


[ene Se See End of Interna! DB2 Information eee 


System Action: DB2 is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Reassemble DSN6SPRM and 
relink-edit the DSNZPARM load module. This is done by resub- 
mitting the installation job stream, DSNTIJUZ, that built the load 
module named in the -START DB2 command 'PARM= ' param- 
eter. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


00E30016 


Explanation: DSNTSTR2 loaded an out-of-date system param- 
eter CSECT DSN6SYSP. This error can occur only if code main- 
tenance has been applied, and CSECT DSN6SYSP in the load 
module specified in the 'PARM=' parameter of the -START 
DB2 command has not been reassembled. This abend is 
issued after message DSNT106I is generated. 


| Internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


Ls End of Internat DB2 Information ___———_| 


System Action: DB2 is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Reassemble DSN6SPRM and 
relink-edit the DSNZPARM load module. This is done by resub- 
mitting installation job stream, DSNTIJUZ, that built the load 
module named in the -START DB2 command 'PARM= ' param- 
eter. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


00E30017 


Explanation: While loading the DB2 database services function 
recovery and emergency shutdown modules, the Service Con- 
troller function abends with this reason code. This is because it 
detected a load module which was loaded with an invalid 
addressing capability. The abend is preceded by message 
DSNT107E. 


| Internal DB2 Information ~ ad aT 


This abend reason code is issued by the foHowing CSECT(s): 
DSNTSTRT 


Ue ee End of Internal DB2 Information eee | 


System Action: DB2 database services startup.is terminated. 


System Programmer Response: Refer to message DSNT107E. 


DB2 Codes 4-149 


00E30018 — 00E30021 


Problem Determination: Refer to message DSNT107E. 


00E30018 


Explanation: The service controller has determined that the 
number of concurrent threads specified by the installation and 
the number of concurrent databases specified by the installa- 
tion cannot be supported in the amount of virtual storage avail- 
able. 


aR. eee Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
- DSNTSTR2 


— End of internal DB2 Information el 


System Action: A record is written to SYS1.L.OGREC, and an 
SVC dump is requested. DB2 is terminated with abend code 
‘O4F'. 


Operator Response: Notify the system programmer. 


System Programmer Response: Decrease the number of con- 
currently active databases. The value for concurrently active 
databases is specified as the DSMAX parameter in the 
DSNZPARM macro DSN6SPRM. 


To correct the problem, you may have to adjust CTHREAD and 
DSMAX. The maximum amount of virtual storage required by 
DB2 includes both the amount of virtual storage required to 
support CTHREAD concurrent users (defined in DSN6SYSP) and 
DSMAX concurrent databases. It is recommended that you use 
the DB2 install pane! DSNTIPE to recalculate the minimum 
amount of storage required for your environment. 


Probiem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5, 9. 


O0E30019 


Explanation: The Service Controller has determined that the 
number of concurrent threads specified by the installation 
cannot be supported by the amount of virtual storage available. 


[ aa Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


ete eae End of Internal DB2 Information Fe a! 


System Action: A record is written to SYS1:LOGREC, and an 
SVC dump is requested. DB2 is terminated with abend code 
‘O4F'. 


Operator Response: Notify the system programmer. 


System Programmer Response: Decrease the number of con- 
currently active threads. The value for concurrently active 
threads is specified as the CTHREAD parameter in the 
DSNZPARM macro DSN6SYSP. 


To correct the problem, you may have to adjust CTHREAD and 
DSMAX: The maximum amount of virtual storage required by | 
DB2 includes both the amount of virtual storage required to 
support CTHREAD concurrent users and DSMAX concurrent 
databases (defined in DSN6SPRM). It is recommended that you 
use the DB2 install panel DSNTIPE to recalculate the minimum 
amount of storage required for your environment. 


4-150 DB2 Messages and Codes 


| 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 14, 
5, 9. 


OQ0E3001A 


Explanation: Either the maximum number of concurrently 
active threads is Jess than or equal to zero, or CSECT 
DSN6SYSP is invalid. 


| oa ia Internal DB2 Information eae 


This abend reason code is issued by the following CSECT(s): 
DSNTSTR2 


Di ee End of Internal DB2 Information eee ooo 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is terminated with abend code 
'O4F'. 


Operator Response: Notify the system programmer. 


System Programmer Response: If the maximum number of 
concurrently active threads specified in CSECT DSN6SYSP is 
less than or equal to zero, specify a new one. If it is not, gen- 
erate a new DSNZPARM load module. 


The value is specified either by the CTHREAD parameter of the 
DSN6SYSP assembler macro in the DSNTIJUZ job stream or it 
is specified in the DSNTIPE installation pane}. All other param- 
eters contained in this version of the CSECT must also be spec- 
ified. 

To generate a new DSNZPARM load module: 


¢ Resubmit the installation job DSNTIJUZ with the link-edit 
SYSIN file NAME parameter matching the -START DB2 
PARM= parameter, or 

¢ Reassemble DSN6SYSP and relink-edit the DSNZPARM 
load module by resubmitting the installation job DSNTIJUZ. 
The link-edit SYSIN file NAME parameter matching the 
-START DB2 PARM= parameter. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 3, 5, 9. 


00E30021 


Explanation: A processing error has occurred during authori- 
zation checking. 


[ y= Internal DB2 Information OY 


This abend reason code is issued by the following CSECT(s): 
DSNTAXACG 


tee eee End of Internal DB2 Information eee) 


System Action: The request to allocate a plan to the authori- 
zation ID is denied. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to /BM DATABASE 2 
Version 2 Release 2 Diagnosis Guide and Reference for failure 
analysis procedures. 


| 
| 
| 


Problem Determination: Collect the fotlowing diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 


00E30034 


Explanation: The authorization ID associated with this con- 
nection is not authorized to use the specified plan name. 


| Internal DB2 Information ee oa 


This abend reason code is issued by the following CSECT(s): 
DSNTAUTH 


en ree End of Internal DB2 Information ieee eet 


System Action: The request to allocate a plan to the authori- 
zation ID is denied. 


User Response: You must request authority to execute the 
plan either from the binder of the plan or from another author- 
ized person. 


00E30035 


Explanation: A processing error has occurred during authori- 
zation checking. 


| Internal DB2 Information ~ = ea 


This abend reason code is issued by the following CSECT(s): 
DSNTAUTH 


a End of Interna! DB2 Information ae 


System Action: The request to allocate a plan to the authori- 
zation ID is denied. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 5. 


00E30036 


Explanation: A processing error has occurred during authori- 
zation checking. 


| Internal DB2 Information — 4H 


This abend reason code is issued by the following CSECT(s): 
DSNTLBAC 


Sea eee End of Internal DB2 Information peo eal 


System Action: The IRLM query request is denied. 
User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 


nosis Guide and Reference for failure analysis procedures. 


00E30034 — 00E30041 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 


00E30037 


Explanation: An internal logic error occurred while invoking a 
distributed transaction manager function. 


| Internal DB2 Information “| 


This abend reason code is issued by the following CSECT(s): 
DSNTDINQ DSNTLSUS DSNTCGET 


Lo End of Internal DB2 Information et Se ee 


System Action: DB2 writes a SYS1.LOGREC record and 
requests a SVC dump. 


User Response: Notify the system programmer. 


Operator Response: Collect the SYS1.LOGREC listing and the 
SVC dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00E30040 


Explanation: An internal logic error occurred while the catalog 
access function was being invoked. 


rT t™~™CS Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTCSRC 


tiga ee End of Internal DB2 information ee eal 


System Action: The START RLIMIT command fails. The gov- 
erning status prior to issuing this command continues 
unchanged. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: At the time of the abend, the registers 
contain the following information: 


Register Contents 

0 Address of the catalog access package param- 
eter list 

2 Catalog access return code 

3 Catalog access reason code 

4 Data manager return code 

5 Data manager reason code 

7 CT address 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E30041 


' Explanation: An internal error occurred when trying to obtain a 


limit from the resource limit specification table. 


DB2 Codes 4-151 


00E30065 — 00E30067 


| Internal DB2 Information Pee 7 | 


This abend reason code is issued by the following CSECT(s): 
DSNTCGET 


oe ee End of Interna! DB2 Information eee eel 


System Action: A record is written to SYST1.LOGREC, and an 
SVC dump is requested. The requested execution unit is abnor- 
mally terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5, 


00E30065 


Explanation: The service controller’s BIND processor detected 
an error in the user’s database request module (DBRM) while 
building the SYSDBRM record. 


pp ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTBCM1 


oer End of Internal DB2 Information ee ee 


System Action: The BIND command fails. 


User Response: An invalid field in the DBRM was found while 
processing the BIND command. The DBRM might be bad. 
Rebuild the DBRM and reissue the BIND command. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
3, 5. 


00E30066 


Explanation: The service controlier’s BIND processor has 
detected an invalid release dependency mark in the cursor 
table. 


| = = : Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNTBBP 


eee ota 2s End of Internal DB2 Information tte eat | 


System Action: The BIND command fails. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


4-152 DB2 Messages and Codes 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
3, 5. 


The service controller module DSNTBBP detected an unknown 
value in the CTRELDEP field of the BIND CT. The BIND CT is 
pointed to by GPR7 at the time of the abend and is mapped by 
DSNDCT. The one byte CTRELDEP field should have been set 
by the RDS BIND processor (DSNXEPR) or one of the functions 
it invokes. 


00E30067 


Explanation: The BIND process program abended while 
attempting to use a BIND parameter. This usually indicates that 
the parameter list provided to the service controller BIND func- 
tion is invalid (bad addresses, incorrect key, and so forth). 


: ri internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTBAP, DSNTBAP1 


eee End of Internal DB2 Information eee ete 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The BIND subcommand is terminated. 


User Response: Notify the system programmer. 


System Programmer Response: This is an internal DB2 error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures and for information about dump analysis and 
service aids. 


Problem Determination: Register 2 contains an indication of 
the type of parameter as follows: 


00000101 
00000102 
00000103 


input parameter list. 

Communication information block (CIB). 

Invalid BIND subcommand name. Registers 3 and 4 
contain the invalid subcommand name. 

00000104 Subcommand information block (SIB). 

00000201 DBRM member name list. 

00000202 Plan-!D list. 


00000203 Message block in user storage. Other register con- 
tents are as follows: 
R3 R4 
< 4 Simple reference 
R8 = zero 
>0 >4 MVCL 
R8 = From address 
R4 = move length 
To and from lengths are equal. 
0 >4 GETMAIN for user storage failed 
R4 = storage length required 
R8 = GETM 
<0 >4 FREEMAIN of user storage failed 
R4 = length of storage of free 
R8 = address of storage to free 
00000204 Message block in user storage. 


R8 = Message block address. 


Except as indicated above, the information in the other. regis- 
ters is as follows: 


R3 Parameter address 

R4 Parameter length 

R5 Parameter storage key 

R8 input parameter list address 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 19. 


00E30068 


Explanation: A function invoked by a BIND subcommand has 
returned an unexpected error. 


| : Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 


DSNTAAL DSNTBAB DSNTBAP1 
DSNTBBP DSNTBCM1 DSNTBFR 
DSNTBRB 


ee End of Internal DB2 Information eoee wee 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The BIND subcommand is terminated. 


User Response: Notify the system programmer. 


System Programmer Response: This is an internal DB2 error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: The service controller code has 
detected .an internal inconsistency. The problem can be deter- 
mined by analyzing the CSECT involved in the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30069 


Explanation: An attempt to allocate a cursor table (CT) failed. 


| Internal DB2 information ~— ———— > ¢h 


This abend reason code is issued by the following CSECT(s): 
DSNTXSTB DSNTDMST DSNTDSTP 


aoe End of Internal DB2 Information Fears 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abended. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is an internal DB2 error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: The service controller code has 
detected an interna! inconsistency. The problem can be deter- 
mined by analyzing the CSECT involved in the abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30068 — 00E30071 


00E30070 


Explanation: An attempt was made to use the IMS/VS 
Resource Lock Manager (IRLM) facilities, but the IRLM was not 
available. Either the RLM had not been started by the oper- 
ator, or the IRLM has encountered a problem causing it to ter- 
minate abnormally. 


[ 5 eae Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 


DSNTAAL DSNTBAB DSNTBCM1 
DSNTBFR DSNTBRB DSNTSFST 
DSNTSGST DSNTSINI 


ee ee End of Internal DB2 Information fines Sd 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The requesting execution unit is 
abended. 


User Response: Notify the system programmer. 


Operator Response: The IRLM should be started before the 
DB2 subsystem is started. If this does not resolve the problem 
(that is, if the IRLM actually was started before DB2 was 
started) notify the system programmer. 


System Programmer Response: This is probably not a DB2 
problem. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Probiem Determination: If IRLM abended, refer to the IRLM 
Diagnosis Guide for further failure analysis procedures. Other- 
wise, ensure that the IRLM is started before the -START DB2 
command is issued. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 9, 17. 


00E30071 


Explanation: Either DB2 terminated without successfully 
signing off from IRLM, or another subsystem with the same 
SSNAME is still connected. This abend reason code accompa- 
nies message DSNT380I. 


fa: = — internal DB2 Information 4S | 


This abend reason code is issued by the following CSECT(s): 
DSNTLIDE 


{| End of internal DB2 Information = 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abended. 


Operator Response: Determine if another DB2 subsystem is 
active. If another subsystem is not active, and IMS/VS is not 
sharing the same IRLM, cancel IRLM prior to starting DB2. 
Regardless, notify the system programmer. 


System Programmer Response: Obtain a copy of 
SYS1.LOGREC and the SVC dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


If the error was caused by a previously unsuccessful QUIT from 
the IRLM, manually stop IRLM. If IMS/VS is using the same 
IRLM, refer to the IMS/VS documentation to determine the effect 
of IRLM terminating while IMS/VS is connected. 


DB2 Codes 4-153 


00E30072 — 00E30074 


If you are running multiple versions of DB2, ensure that the 
SSNAME specified by the DSN6SPRM macro during the installa- 
tion of the member DSNZPARM is not the same as the SSNAME 
in another version of DB2. 


Problem Determination: A previously unsuccessful sign-off 
from the IRLM is documented by an abend of X'00E30075' 
during the previous termination of DB2. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5, 9, 17. 


00E30072 


Explanation: An error was encountered during an IRLM lock 
query request. 


| re internal DB2 Information el eit | 


This abend reason code is issued by the following CSECT(s): 
DSNTLQRY, DSNTLAGL 


Se Xe ee End of Internal DB2 Information _ 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The execution unit is terminated. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.L.OGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures and for information about dump analysis and 
service aids. 


Problem Determination: At the time of the abend, the registers 
contains the following information: 


R2 Address of the lock request RLPL 

R4 Address of the IRLM query request RLPL 
R5 Address of the IRLM query RLQD 

R7 CT address 


Refer to “Section 5. IRLM Messages and Codes” on page 5-1 
for information identifying IRLM return and reason codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 17. 


00E30073 


Explanation: An unrecoverable system error occurred while 
processing a LOCK or UNLOCK request. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNTAAL DSNTBAB DSNTBCM1 
DSNTBFR DSNTBRB DSNTSFST 
DSNTSGST DSNTSINI 


ee End of Internal DB2 Information fee 


4-154 DB2 Messages and Codes 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The requested execution unit is 
abended. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: The service controller (SC) subcom- 
ponent has detected an internal inconsistency. The problem 
can be determined by analyzing the CSECT involved in the 
abend. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 17. 


00E30074 


Explanation: A global out-of-storage condition was encount- 
ered by the IMS/VS Resource Lock Manager during the proc- 
essing of a LOCK or UNLOCK request. 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 


DSNTAAL DSNTBAB DSNTBCM1 
DSNTBFR DSNTBRB DSNTSFST 
DSNTSGST DSNTSINI 


er End of internal DB2 Information eee | 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The requesting execution unit is 
abended. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably not a DB2 
problem. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis 
and service aids. 


Probiem Determination: The name of the module issuing the 
abend is recorded in the SYS1.LOGREC entry. It is also 
recorded in the SVC dump as the CSECT involved in the abend. 
A parameter in the IRLM procedure specifies the amount of the 
common service area (CSA) to be used by IRLM. Do one of the 
following: 


¢ Increase the CSA limit. 

° Use a local IRLM (that is, an IRLM option that causes IRLM 
to operate from another address space). 

¢ Using !IRLM lock tracing, determine what application is 
acquiring so many locks that it causes the IRLM CSA limit to 
be exceeded. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 


00E30075 


Explanation: During the normal sign-off from IRLM or during 
the abnormal! shutdown of DB2, an AUTO-STOP of IRLM using 
SVC 34 abnormally terminated. Message DSNT3831 is issued. 


C= internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTLQUI 


Wine aces End of Internal DB2 Information ee 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abended. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably a DB2 
internal error. Obtain a copy of SYS1.LOGREC and the SVC 
dump. Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The name of the CSECT issuing the 
abend is found in both the SYS1.LOGREC and the SVC dump. 
Register 2 contains the SVC return code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3, 5, 35. 


00E30076 
Explanation: An attempt to sign-off from IRLM failed. 


| Internal DB2 Information ~< “dl 


This abend reason code is issued by the following CSECT(s): 
DSNTLQUI 


Lend of Internal DB2 Information ener: , 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abended. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an internal 
DB2 error. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The service controller subcomponent 
has detected an internal inconsistency. The problem can be 
determined by analyzing the CSECT involved in the abend. 
This CSECT is found in both the SYS1.LOGREC and the SVC 
dump. 


The request parameter list (RLPL) used during the sign-off 
process resides in the IRLM interface manager’s communi- 
cation block (DSNTLMC) from ACOM. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


| 


00E30075 — 00E30079 


00E30077 


Explanation: A database command processor encountered an 
error when attempting to create a cursor block (CUB) on a DB2 
catalog table. 


Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNTDINQ DSNTDMST DSNTDDIS 


es ts End of Internal DB2 Information sd 


System Action: An error was detected during the generation of 
messages to satisfy a DATABASE command. A DSNT305I 
message appears on the console of the requester, with the RC 
parameter of 12 and a REASON parameter of X'00E30089' . 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an internal 
DB2 error. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis 
and service aids. 


Problem Determination: Diagnostic information may be found 
in the Display Command Communication Area, whose address 
is found in register 8, and by the Display Command subcode in 
register 2. 


00E30078 


Explanation: IRLM called the service controller IRLM interface 
status exit with register 0 equal to 1 in order to notify DB2 that 
IRLM is terminating. This is not a DB2 subsystem error. 


| Internal DB2 Information ee 


This abend reason code is issued by the following CSECT(s): 
DSNTLSTA 


a End of Internal DB2 Information | 


System Action: DB2 is abended when iRLM is terminated 
before DB2 is terminated. An entry is written to SYS1.LOGREC. 


00E30079 


Explanation: An error was encountered on return from the 
IMS/VS Resource Lock Manager (iRLM) IDENTIFY function. 


a ~~ Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNTLIDE 


Pte gi ae at End of internal DB2 Information Si eet 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abended. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This may be an internal DB2 
error or an operator procedure problem. Obtain a copy of 


DB2 Codes 4-155 


00E30080 — 00E30083 


SYS1.LOGREC and the SVC dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Inthe SVC dump, register 2 contains 
the return code and register 3 contains the reason code from 
the identify function to the IRLM. Examine the reason code in 
register 3, either from the dump or system console log. A 
reason code of 4008 indicates that the identify function code (51, 
X'33') does not exist in the IRLM SSVT. This may be due to the 
operator issuing a stop IRLM command followed by a start DB2 
command before the IRLM has completed termination proc- 
essing. The sequence of commands can be determined from 
the system console log. 


A reason code of 4008 indicates that the IRLM is unavailable, 
that is, IRLM is not started and the autostart is not requested by 
parameters in DSNZPARM. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30080 


Explanation: An attempt was made to start the IMS/VS 
Resource Lock Manager (IRLM) using the MGCR (SVC 34), and 
a nonzero return code was returned. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTLIDE 


I gins Ste eee End of Internal DB2 Information we Seal 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. DB2 is abended. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Examine the SVC return code 
to determine whether this is a system problem or a DB2 internal 
problem. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: Register 2 contains the SVC return 
code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 35. 


00E30081 


Explanation: An attempt was made to start the IMS/VS 
Resource Lock Manager (IRLM). IRLM did not come up in the 
time limit specified to DB2. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTLIDE 


eer End of Internal DB2 Information eee 


4-156 DB2 Messages and Codes 


System Action: A record is written to SYS1.LOGREC. DB2 is 
abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: This problem can be circum- 
vented. To do this, either specify a longer time limit in the 
SPRMSWT parameter of the DSN6SPRM assembler macro in 
the DSNTIJUZ job stream, or update the !RLM system wait time 
parameter in the DB2 Installation Update panel. You must also 
specify all other parameters contained in this version of the 
CSECT. Then resubmit the installation job DSNTIJUZ with the 
link-edit SYSIN file NAME parameter that matches the -START 
DB2 'PARM=' parameter. Refer to Section 5 (Volume 2) of 
Administration Guide for additional information. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9, 35. 


00E30082 


Explanation: !RLM discovered a bad request parameter list 
(RLPL). This may occur if the RLPL storage is overlaid while an 
agent is suspended. 


| Internal DB2 Information ~~ SS ~| 


This abend reason code is issued by the following CSECT(s): 
DSNTLSUS 


ee End of Internal DB2 Information eee ee S| 


System Action: The execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: An IRLM request was made that IRLM 
could not honor immediately. {RLM called DSNTLSUS to 
suspend the request. While waiting, the request parameter list 
(RLPL) was changed and is no longer valid. Someone may be 
reusing the RLPL, or the storage may have been overlaid. 


Register 2 contains a pointer to the RLPL. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 





00E30083 


Explanation: This agent has been selected as the victim of a 
deadiock. 


This reason code is not used in abends. 


[ ——~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNTAAL DSNTBAB DSNTBCM1 
DSNTBFR DSNTBRB 


_————— End of Interna! DB2 Information eee! 


00E30084 


Explanation: This code is used in the REASON parameter of 
the DSNT3051 database command message to inform the 
requestor that an error was detected while constructing the 
database command display. Other entries in the SYS1.LOGREC 
will help identify the true source of the error. 


= Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTDMSG DSNTDMUL 


Vege k epee End of Internal DB2 Information pe 


System Action: A DSNT305I message appears on the console 
of the requestor, with an RC parameter of 12 and a REASON 
parameter of E'00E30084'. This is a DB2 subsystem error. No 
SVC dump is requested because a prior dump of the failing sub- 
component is expected. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures and for information about dump analysis and 
service aids. 


00E30085 


Explanation: An error was indicated by the RDS Authorization 
function. This is an internal DB2 error. 


= —— Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNTDMI 


et eee End of Internal DB2 Information ae 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The command is abended after dis- 
playing a DSNT3051 message with an RC parameter of 12 anda 
REASON parameter of X'00E30089'. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is an interna! DB2 error. 
Obtain a copy of SYS1.LOGREC and the SVC dump. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures and for information about dump analysis and 
service aids. 


Problem Determination: The error return code address of the 
Display Command Communication Area is found in register 8. 


00E30084 — 00E30090 


00E30086 


Explanation: An error was indicated by the data manager (DM) 
subcomponent. This is probably an interna! DB2 error. 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNTDMI 


ede See ie End of Internal DB2 Information pee 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. The command is abended after dis- 
playing a DSNT305! message with an RC parameter of 12 anda 
REASON parameter of X'00E30089'. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an internal 
error. Obtain a copy of SYS1.LOGREC and the SVC dump. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures and for information about dump analysis 
and service aids. 


Problem Determination: The error return code of the data 
manager may be found in the cursor table (CT), the address. of 
which is found in register 7. 


00E30089 


Explanation: This code is used in the REASON parameter of 
the DSNT305! database command message to inform the 
requester that the execution unit supporting the database 
command processor has terminated. Other entries in the 
SYS1.LOGREC identify the source of the error. 


[- Internal DB2 Information aera 


This abend reason code is issued by the following CSECT(s): 
DSNTDMSG 


ee End of Internal DB2 Information oe eo 


System Action: A DSNT305I message appears on the console 
of the requestor, with an RC parameter of 12 and a REASON 
parameter of X'00E30089'. This is probably a DB2 subsystem 
error. No SVC dump is requested because a prior dump of the 
failing subcomponent is expected. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: See the SYS1.LOGREC for 
prior failure. 


00E30090 


Explanation: A service controller internal inconsistency has. 
been encountered during message generation. 


DB2 Codes 4-157. 


00E30091 — 00E30101 


[ Internal DB2 Information 


This abend code is issued by the following CSECT(s): 
DSNTDMSG, DSNTDMUL 


| eased End of Internal DB2 Information eaten 


‘System Action: A record is written to SYS1.LOGREC, and an 


SVC dump is requested. The execution unit is abended. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: At the time of the abend, register 2 
contains the message number that was to be generated. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E30091 


Explanation: A failure was detected during the retry process of 
DB2 recovery. 


System Action: DB2 is abnormally terminated after a record is 
written to SYS1.LOGREC and an SVC dump is requested. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This is probably an internal 
DB2 error. Obtain a copy of SYS1.L.OGREC and the an SVC 
dump. Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures. 


Problem Determination: This abend is issued by DSNTFRCV of 
the service controller (SC) subcomponent. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E30092 


Explanation: A retry recovery failure has been detected. This 
is a critical error. 


= ~~ internal DB2 Information ~ - 3. 


This abend reason code is issued by the following CSECT(s): 
DSNTFRCV 


—_——— a End of Internal DB2 Information ee 


System Action: DB2 is abnormally terminated. This is prob- 
ably a DB2 subsystem error. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a copy of the 
SYS1.LOGREC and the SVC dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: The service controller recovery 
module has detected an internal inconsistency. The problem 
can be determined by analyzing the CSECT involved in the 
abend. The name of this CSECT is found in both the 


‘SYS1,LOGREC and the SVC dump. 
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Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E30093 


Explanation: A shortage of virtual storage exists in the data- 
base services address space. 


Operator Response: Resubmit your request when DB2 activity 
diminishes. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00E30094 


Explanation: A shortage of virtual storage exists in the data- 
base services address space. However, there should have 
been enough space available. The fixed size of the emergency 
pool is probably too small. 


System Action: A record is written to SYS1.LOGREC. An SVC 
dump is requested. DB2 is abnormally terminated. 


Operator Response: Resubmit your request when DB2 activity 
diminishes. 
System Programmer Response: This is a DB2 error. Obtaina 


copy of SYS1.LOGREC and the SVC dump. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


OQOE3009E 


Explanation: The plan depends on new facilities of the release 
from which fall back has occurred. 


| Internal DB2 Information ad | 


This abend reason code is issued by the following CSECT(s): 
DSNTAAL 


bose ae es End of Internal DB2 Information Be thee ced 


System Action: The allocation for the user failed. 


User Response: Do not use this plan until your DB2 subsystem 
is remigrated to the newer release. 


System Programmer Response: Warn the user community NOT 
to run this plan until you have remigrated to the newer release. 


00E30101 


Explanation: The result of issuing a SETFRR macro indicates 
that this FRR is not the top FRR. 


| internal DB2 Information ~~ ae | 


This abend reason code is issued by the following CSECT(s): 
DSNTAC1 


ee End of Internal DB2 Information | 


System Action: A record is written to SYS1.LOGREC. An SVC 
dump is requested. 


System Programmer Response: This is probably a DB2 
internal error. Obtain a copy of SYS1.LOGREC and the SVC 
dump. Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
5. 


00E30104 


Explanation: This reason code is used by the service con- 
troller (SC) subcomponent to respond NO on a prepare-to- 
commit notification. 


oT = ——— Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTAC1 


a ere, End of Interna! DB2 Information Shae 


System Action: If the service controller indicates that DB2 
cannot commit to perform the work requested by the application 
since the last commit point, it responds NO on the prepare-to- 
commit notification (COMMIT1). This forces the commit to be 
changed to an abort, causing the work performed by the appli- 
cation since the last. commit point to be backed out. 


00E30301 


Explanation: This reason code is used by the automatic BIND 
function to indicate that no plan exists for the plan-ID currently 
being allocated. 


[ ~~ _ Internal DB2 Information ~— ~~~ 


This abend reason code is issued by the following CSECT(s): 
DSNTBAB 


TS eases End of Internal DB2 Information a 


System Action: DB2 terminates abnormally. 


00E30302 


Explanation: This reason code is used by the automatic BIND 
function to indicate that the plan currently being allocated is not 
operational. That upon which the plan was dependent has been 
altered or dropped, causing the automatic BIND for the plan to 
fail. 


= —————— Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNTBAB 


aed tes End of Internal DB2 Information Qe eI 


System Action: DB2 terminates abnormally. 


System Programmer Response: Determine what has made the 
plan not operational. Issue a REBIND subcommand for the 
pian. 


00E30104 — 00E30700 


00E30402 


Explanation: This subcode is found in register 2 to clarify 
abend reason code X'00E30077'. See X'00E30077' for more 
information. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNTDINQ 


L End of Internal DB2 Information ee Sens 


00E30405 


Explanation: This subcode is found in register 2 to clarify 
abend reason code X'00E30077'. See X'00E30077' for more 
information. 


| Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNTDINQ 


(eeceaece aah End of Internal DB2 Information ee | 


00E30406 


Explanation: This subcode is found in register 2 to clarify 
abend reason code X'00E30077'. See X'00E30077' for more 
information. 


— ——— Internal DB2 Information oo 


This reason code is issued by the following CSECT(s): 
DSNTDMST 


Lo End of Internal DB2 Information eaten 


00E30407 


Explanation: This subcode is found in register 2 to clarify 
abend reason code X'00E30077'. See X'00E30077' for more 
information. 


[ pe eee Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNTDDIS 


(ee ee End of Internal DB2 Information eee 


00E30700 


Explanation: A resource limit as determined from the active 
Resource Limit Specification Table has been exceeded. The 
SQL statement has been terminated with a -905 SQL code. 


| : Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNBxxxx 


a End of Internal DB2 Information eee eee 


DB2 Codes 4-159 


System Action: The current SQL statement contains a -905 SQL Operator Response: Notify the system programmer. 
code: System Programmer Response: A SQL statement used too 


User Response: See the text for the -905 SQL code. It will much resource space. Refer to Section 5 of Diagnosis Guide 
specify the resource limit that was exceeded. The -905 text will and Reference for failure analysis procedures. 
alee includesne nem - Me Kesource om Specification TAD Probiem Determination: Collect the following diagnostic items 
that was used to derive the limit. Determine why the limit was : Rew : ie se he 

listed in Appendix B, “Problem Determination” on page X-5: 1, 
exceeded. Z 
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Utilities Reason Codes (X'E4') 


Many of the utilities codes ask you to determine 
the failing environment. This means that you 
should determine the following things: 


e The address space in which the failure 
occurred 

e The utility that was running 

e Whether it was a restart of a utility that failed 
previously 

¢ Whether the job step invocation was through 
the DSNUTILB program 

e Whether a -DISPLAY or -TERM UTILITY 
command involved 


When DB2 resources are unavailable to utilities, 
message DSNT500!I will be issued along with the 
utility reason code. Refer to message DSNT500I 
for the correct course of action. 


00E40001 


Explanation: No cursor table was present at entry to database 
services portion of utility. 


| “—~ Internal DB2 Information a a 


This abend reason code is issued by the following CSECT(s): 
DSNUGRAR 


Ui eee End of Internal DB2 Information teed 


System Action: The utility job step that caused the function to 
be requested is abended. Utility processing is not initiated. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45 


00E40002 


Explanation: The caller of the database services portion of the 
utility was in the wrong protect key. 


| Internal DB2 Information — —T 


This abend reason code is issued by the following CSECT(s): 
DSNUGRAR, DSNUGBAC 


ee End of Internal DB2 Information oe ee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


00E40001 — 00E40004 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


lf a JOBLIB or STEPLIB is being used in the batch utility job, 
check that all application program libraries included in the con- 
catenation are authorized. 


Check that the batch utility program DSNUTILB was included in 
the MVS program properties table during the installation of 
DB2. The entry for DSNUTILB in the MVS program properties 
table was provided by MVS. Refer to Section 5 of Diagnosis 
Guide and Reference for symptom determination and failure 
analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45 


00E40003 


Explanation: An error occurred while getting FRBPARM from 
application storage. 


—_ -— Interna! DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGRAR 


eee ees End of Interna! DB2 Information eset ote! 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


System Programmer Response: Determine the failing environ- 
ment., in particular whether invocation was through program 
DSNUTILB. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. 


Problem Determination: If the environment was DSNUTILB; the 
problem could be internal. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5,31, 45. 


00E40004 


Explanation: An error occurred while getting FRB from appili- 
cation storage. 


oe = Internal DB2 Information aaa 


This abend reason code is issued by the following CSECT(s): 
DSNUGRAR 


ee End of Internal DB2 information _ 


System Action: The utility job step that caused the function to . 
be requested is abended. The utility job is placed in the 
stopped state. 


DB2Codes 4-161 


00E40005 — 00E40007 


System Programmer Response: Determine the failing environ- 
ment. In particular, determine whether invocation was through 
program DSNUTILB. Refer to Section 5 of Diagnosis Guide and 
Reference for symptom determination and failure analysis pro- 
cedures. 


Problem Determination: If the environment was DSNUTILB, the 
problem could be internal. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40005 


Explanation: A nonzero reason code was returned from MVS 
sort. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSOR 


te peg aA cease End of Internal DB2 Information Beh oe 


System Action: Any error message generated by sort in con- 
junction with the nonzero reason code is directed to the 
device/data set identified by the UTPRINT DD card in the utility 
job step. 


Error message DSNUO44E, that contains the nonzero reason 
code, is directed to the device/data set identified by the 
SYSPRINT DD card in the utility job step. 


User Response: Determine the cause ofthe error. If the error 
can be corrected, the utility may be restarted from the begin- 
ning of the sort phase by using the ‘'RESTART(PHASE)' param- 
eter. If the error prevents the utility from completing, the 
-TERM command should be issued to remove the stopped utility 
from the system. The -TERM UTILITY should seldom be used 
when the stopped utility is REORG. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


Problem Determination: This abend is accompanied by the 
utility message DSNUO44E, that contains the sort reason code 
and an SVC dump. In most cases, the error messages from 
SORT that are sent to the device/data set identified by the 
UTPRINT DD card identify the problem. The dump may not be 
needed. If SORT is unable to open the UTPRINT data set, only 
the message and abend are provided. In this case, correct the 
problem associated with the UTPRINT DD card, and restart the 
job with the RESTART(PHASE) option. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40006 


Explanation: An error has been detected while manipulating 
the utility-in-progress bits of the DBA table. If the abend was 
issued from CSECT DSNUGSER, an attempt was probably made 
to set utility-in-progress on and the utility-in-progress condition 
was not properly reset after execution of a prior utility. 
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| ~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSRI, DSNUGSRX, DSNUGTER 


eee End of Internal DB2 Information nee 


System Action: Utility processing is abnormally terminated. 


System Programmer Response: Use the -DISPLAY UTILITY 
command to display the status of any utilities in progress. 
Determine if another utility is active on the same table space. 
Use the -DISPLAY DATABASE command to determine if the 
table space has a utility-in-progress condition set on. 


The utility-in-progress bit is turned on only for table spaces. If 
a utility is run against an index, the utility-in-progress bit is 
turned on for the appropriate table space. 


A utility-in-progress condition set without a corresponding entry 
for an active or stopped utility in the SYSUTIL table is an incon- 
sistent condition caused by a prior error. This may be resolved 
by issuing a -START DATABASE command specifying the 
proper table space with the ACCESS(FORCE) parameter. This 
will cause the utility-in-progress status to be cleared. If the 
problem cannot be corrected, determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40007 


Explanation: The COPY utility function is unable to open the 
table space as directed. The failure may occur, because the 
table space is currently not available. The failure could also be 
an internal error. 


| Internal DB2 Information ——— “| 


This abend reason code is issued by the following CSECT(s): 
DSNUBBFR 


Wes ett ee End of internal DB2 Information eee 


System Action: If the table space is currently not available, a 
DSNT500I RESOURCE NOT AVAILABLE message is directed to 
the device/data set identified by the SYSPRINT DD card. The 
utility job step is placed in the stopped state. 


User Response: If the abend was accompanied by a DSNT500! 
message, look up DSNTS500I in “Service Controller and Installa- 
tion Messages (DSNT...)” on page 3-121 to determine the cause 
of the resource unavailability. The utility can be restarted when 
the resource becomes available, or the utility job step can be 
terminated and the job resubmitted at a later time. 


If a DSNT5001 message was not issued, an internal processing . 
error has occurred. Provide the system programmer with 
dumps and messages for fault analysis. 


Operator Response: After the environmental information has 
been determined, an operator with SYSOPR authority can ter- 
minate the utility job step and free the resources (this may not 
be necessary). 


System Programmer Response: if a DSNT500! message pre- 
ceded the abend, follow the procedures outlined under that 
message number in “Service Controller and Installation Mes- 
sages (DSNT...)” on page 3-121 for Problem Determination. 
Otherwise, determine the failing environment. Refer to Section 
5 of Diagnosis Guide and Reference for symptom determination 
and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40009 


Explanation: An error has been detected while attempting to 
create an internal control block. 


——~ Internal DB2 Information ~~ ————— a 


This abend reason code is issued by the following CSECT(s): 
DSNUGACC, DSNUGUTC 


ee End of Internal DB2 Information pee 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500I. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500! in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31,45. 


O0E4000A 


Explanation: An error has been detected while force closing a 
.page set. 


[ > = ce ~— Internal DB2 Information ~— : | 


This abend reason code is issued by the following CSECT(s): 
DSNUCLVE, DSNUGACC 


ne eet End of Internal DB2 Information ae 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


| 


00E40009 — 00E4000D 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E4000C 


Explanation: This is an internal control error. The utility sub- 
component that manages the function control flow associated 

with DB2 database services has been requested to performa 

function that it does not recognize. 


—— —"—~_ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUBFFR, DSNUBCOP, DSNUCBFW, DSNUGRAR 


eee End of Internal DB2 Information pet 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


User Response: To determine how much of the requested 
function within the job step was completed, examine the data 
set/device identified by SYSPRINT. Consult the system pro- 
grammer to diagnose the problem. Determine whether the 
utility job step should be terminated in order to release 
resources. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to free resources (this may 
not be necessary). 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for symptom determination and 
failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


00E4000D 


Explanation: An error has been detected while scanning or 
updating table SYSIBM.SYSUTIL. 


[as Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSRI, DSNUGDIS, DSNUGTER 


[ese SA End of Internal DB2 Information a ere 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500!. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
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OOE4000E — 00E40011 


Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 46. 


O00E4000E 


Explanation: An error has been detected while attempting to 
create a cursor block (CUB). 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGACC, DSNUKINE 


[tees End of Internal DB2 Information see Seep 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500I. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500i was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500! in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E4000F 


Explanation: An error has been detected while checking or 
setting the 'DBA table' state (DSNISUSF protocol). 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUGCKP, DSNUGSRI, DSNUGSRX, DSNUGTER 


ee End of Internal DB2 Information eee ees 


System Action: Utilities processing is abended. This abend 
may be accompanied by message DSNT500!. An SDUMP may 
be requested. 


User Response: Correct the resource unavailable condition 
identified by the DSNT500! message and either restart the utility 
from the last commit point or terminate the utility and restart it 
from the beginning. If DSNT5001 was not issued, register 2 con- 
tains a secondary DB2 reason code that will give more informa- 
tion about the problem. 


4-164 1DB2 Messages and Codes 


System Programmer Response: If the conditions identified 
cannot be corrected, determine the failing environment, and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis. 


Problem Determination: Refer to the description of message 
DSNTS500! under that message number in this manual. 


Refer to Figure 4 in Appendix B, “Problem Determination” on 
page X-5 for an explanation of resource type codes. Refer to 
the description of the secondary reason code from register 2 in 
this manual. 


00E40010 


Explanation: A request to IRLM on behalf of a DB2 utility to 
lock a page or an entire table space has failed. This is either 
an internal DB2 or an IRLM problem. The error occurred in the 
database services address space. 


Internal DB2 Information ~~ tons 


This abend reason code is issued by the following CSECT(s): 
DSNUCDA1, DSNUCRVL 


Me sie End of Internal DB2 Information Sees 


System Action: The utility job is abended. An SVC dump is 
requested (with the address of the IRLM parameter list, RLPL, 
in register 4). The utility is placed in the stopped state. 


User Response: Consult the system programmer to diagnose 
the problem. Determine if the utility should be terminated. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to free resources (this may 
not be necessary). 


System Programmer Response: Check the IRLM return and 
reason codes in the RLPL. Refer to Section 5 of Diagnosis 
Guide and Reference for symptom determination and failure 
analysis procedures. 


Probiem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


00E40011 


Explanation: An attempt to extend the error range information 
in the database allocation table (DBAT) failed. 


| internal DB2 Information ~— | 


This abend reason code is issued by the following CSECT(s): 
DSNUCDA1 


Eepoheoee aie End of Internal DB2 Information ee eet 


System Action: The I/O error that did not get recorded in the . 
DBAT table was reported in error message DSNUOS86E, that was 
directed to the device/data set identified by the SYSPRINT DD 
card. The utility job step is placed in the stopped state. 


User Response: The system programmer should be notified 
and given the relevant environmental information. Subsequent 
to its correction, the stopped utility can be restarted using the 
RESTART option, or it can be terminated and resubmitted at a 
later time. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40012 


Explanation: An error has been detected while attempting to 
find a database descriptor block (DBD) address. 


~— Internal DB2 Information ~— es | 


This abend reason code is issued by the following CSECT(s): 
DSNUGACC, DSNUGCKP 


foe ee! End of Interna! DB2 Information Pe atee 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500!. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500i message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. !f DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40013 


Explanation: An error has been detected while creating a ECB 
exit for -STOP DB2. 


aa Internal DB2 Information ~ 


This abend reason code is issued by the following CSECT(s): 
DSNUGBAC 


ae End of Internal DB2 Information ee ee 


System Action: Utilities processing is abended. 


User Response: Notify the system programmer. 


00E40012 — 00E40016 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40014 


Explanation: An error has been detected from the terminate 
thread function. 


~~ Internal DB2 Information ~~~ vs 


This abend reason code is issued by the following CSECT(s): 
DSNUGBAG 


Dis eege ees End of Internal DB2 Information ee 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40015 


Explanation: A RECOVER utility was initiated with the ERROR 
RANGE option specified. The request was rejected when it was 
determined that there was not a sufficient number of alternate 
tracks for the pages in the error range to be recovered. 


; Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUCRVT 


oe ee End of Internal DB2 Information eee 


System Action: The abend was issued in the database services. 
address space. The dumps requested are dependent upon the 
JCL of the utility job step. The utility job step is abended. The 
utility is placed in the 'stopped' state. 


User Response: Recovery may be accomplished by resubmit- 
ting the RECOVER utility without the ERROR RANGE option. 
Recovery can be by data set or the table space as a whole. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to free resources (this may 
not be necessary). 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


00E40016 


Explanation: A Recover utility was initiated with the ERROR 
RANGE option specified. An error was detected by the media 
manager while processing a MMCNVT macro invocation. This 
is an internal error within either DB2-or the media manager.. 
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00E40017 — 00E4001C 


| — Internal DB2 Information a aaa 


This abend reason code is issued by the following CSECT(s): 
DSNUCRVT 


[eee ee a End of Interna! DB2 Information eee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to free resources if that 
should prove necessary (this may not be necessary). 


System Programmer Response: The MMCNVT macro converts 
a VSAM RBA to its physica! track address (CCHHR). At the time 
of abend, the following registers contain relevant information: 


R2 Address of media manager interface block (MMIB). 

R3 Address of field containing VSAM RBA to be converted. 

R4 Address of area to receive CCHHR. 

R5 MMCNVT places UCB address here. 

R8& Return code from media manager. For a description of 
media manager return codes, refer to OS/VS2 MVS 
Media Manager Diagnosis Guide and Reference. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


00E40017 


Explanation: An error has been detected from terminate iden- 


tify. 


= oe Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUGBAC 


{| End of Internal DB2 Information 


System Action: Utilities. processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40018 


Explanation: Either an error was detected during the execution 
of a restarted utility or a condition was detected that may have 
required restart of a utility. A message is issued prior to this 
abend code to indicate the type of error. 
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| : internal DB2 !nformation Sa 


This abend reason code is issued by the following CSECT(s): 
DSNUGBACG 


oer End of Internal DB2 Information Sa ae iol 


System Action: Utility processing is abnormally terminated. 
User Response: Notify the system programmer. 


System Programmer Response: Check messages issued prior 
to this abend code to determine the cause of the error. Correct 
the error, and restart the job. 


Problem Determination: This abend is forced to allow restart of 
the utility when work data sets are used and the disposition is 
(MOD,DELETE,CATLG). 


OOE4001A 


Explanation: An error has been detected while using SVC 99 to 
retrieve information on the DD cards supplied. 


~— Internal DB2 Information a | 


This abend reason code is issued by the following CSECT(s): 
DSNUGCDD 


Eee eee End of Internal DB2 Information | 


System Action: Utility processing is abnormally terminated. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


Problem Determination: This is a DB2 internal error. Refer to 
Section 5 of Diagnosis Guide and Reference for symptom deter- 
mination and failure analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E4001C 


Explanation: An error has been detected while attempting to 
map externals to a specific file object descriptor (OBD). 


~ Internal DB2 Information ee 


This abend reason code is issued by the following CSECT(s): 
DSNUGMAP 


ed End of Internal DB2 Information Beg ate 


System Action: Utilities processing is abnormally terminated. 
The abend may be accompanied by message DSNTS500I. An 
SDUMP may be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. !f DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 


refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500I in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E4001D 


Explanation: An error has been detected while attempting to 
read a row from the SYSIBM.SYSSYNONYMS table. 


ics oe —~ Internal DB2 Information ~~ 


This abend reason code is issued by the following CSECT(s): 
DSNUGMAP 


ee meer End of Internal DB2 Information ae ed 


System Action: Utilities processing is abnormally terminated. 
The abend may be accompanied by message DSNT500!. An 
SDUMP may be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT5001 message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


O0E4001E 


Explanation: An error has been detected while attempting to 
read a row from the SYSIBM.SYSTABLES table. 


fe oa ee — Internal DB2 Information = eee. 4 


This abend reason code is issued by the following CSECT(s): 
DSNUGMAP, DSNUGTBN, DSNUKINP, DSNUCBRK 


en as End of Internal DB2 Information ee 


System Action: Utilities processing is abnormally terminated. 
The abend may be accompanied by message DSNT500!. An 
'SDUMP may be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNTS00! message and either restart the 
utility from the last commit point or terminate the utility and 


00E4001D — 00E40020 


start it again from the beginning. \f DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: |f the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E4001F 


Explanation: An error has been detected while attempting to 
read a row from the SYSIBM.SYSINDEXES table. 


| ~ Internal DB2 Information ~ eae il 


This abend reason code is issued by the following CSECT(s): 
DSNUGMAP 


er End of Internal DB2 Information eaten Shot Se 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500!I. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: [f the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Probiem Determination: See message DSNTS500I in this 
manual. Refer to Figure 4in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix 8B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40020 


Explanation: An error has been detected while attempting to 
RARQ to the database storage. 


+. Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGPRE 


eee End of internal DB2 Information eee ee eee 


System Action: Utilities processing is abended. 
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00E40021 — 00E40024 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40021 


Explanation: Utility processing was performing an AUTHORI- 
ZATION CHECK for the utility user and specified object, when 

an error was detected. A necessary resource for the check was 
not available. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUGMAP, DSNUKINE 


[| End of internal DB2 Information _____—_| 


System Action: Utility processing is abended. | 
User Response: Notify the system programmer. | 


System Programmer Response: Make the resource available 
and either -TERM the utility and resubmit it, or resubmit the 
utility with the RESTART parameter. Refer to message 
DSNTS500! in “Service Controller and Installation Messages 
(DSNT...)” on page 3-121. If the problem can not be corrected, 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis. 


Problem Determination: This abend is accompanied by the 
message DSNT5001, that identifies the unavailable resource. 
The message is written to the SYSPRINT data set. 


00E40022 


Explanation: An error has been detected while attempting to 
read a row from the SYSIBM.SYSUTIL table. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUGSUU 


| Sener End of Internal DB2 Information ee te 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500!. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


4-168 DB2 Messages and Codes 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40023 


Explanation: The internal protocols required for utility update 
of table the SYSIBM.SYSUTIL have been violated. Utility modifi- 
cations to SYSIBM.SYSUTIL were not committed. 


| - : Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUGSRI, DSNUGSRX 


|__ End of internal DB2 Information ______| 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 46. 


00E40024 


Explanation: internal protocols required for utility serialization 
were violated. Specifically, utility serialization cleanup was not 
invoked upon completion of utility processing. 


pes — Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUGUCA 


a End of Internal DB2 Information eee 


System Action: The utility job step is terminated, placing the — 
utility in the stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility. (this may not.be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference-for 
symptom determination and failure analysis procedures. 


Problem Determination: Collect the following diagnostic item 
listed in Appendix B, “Problem Determination” on page X-5: 
46. 


00E40025 


Explanation: Utility processing attempted to allocate resources 
for this utility job step. The allocate protocol has returned a 
nonzero return code. 


| Internal DB2 Information ~— ae ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUGUCA 


er End of Internal DB2 Information es | 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500!. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001I in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40026 


Explanation: A DB2 commit or abort, executed on behalf of a 
utility, has failed. 


| internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUBICO, DSNUCRVO 


(et oe ee End of Internal DB2 Information ee 


System Action: This is an internal DB2 error occurring in the 
application address space. The job step that invoked the utility 
is abended. A dump may or may not be generated, depending 
on the utility job step JCL. 


User Response: Request a dump of the event for the system 
programmer. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to free resources (this may 
not be necessary). 


| 
| 


00E40025 — 00E40028 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for symptom determination and 
failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


00E40027 


Explanation: An error has been detected while attempting to 
update a row of the SYSIBM.SYSUTIL table. 


| Interna! DB2 Information az | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSUU 


re End of internal DB2 Information Dee el 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500!. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: lf the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40028 


Explanation: An error has been detected while attempting to 
COMMIT. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUGUCA, DSNUGAGS 


| <enees End of Internal DB2 Information en es 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 
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00E40029 — 00E40030 


00E40029 


Explanation: An error has been detected while attempting to 
read a row from the SYSIBM.SYSUTIL table. 


a ~—————~~_ Internal DB2 Information ~————— 


This abend reason code is issued by the following CSECT(s): 
DSNUGUCA, DSNUGAGS 


Heese eee End of Internal DB2 Information gee 


System Action: Utilities processing is abended. The abend 
may be accompanied by message DSNT500I. An SDUMP may 
be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500! in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E4002A 


Explanation: The utility SYSUTIL-update service was 
attempting to build a SYSIBM.SYSUTIL table record. The 
SYSUTIL record contains utility job information and checkpoint 
restart information. The amount of information exceeds the 
capacity of the SYSUTIL record. 


aa ~~ ~~ Internal DB2 Information aay | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSUU 


ees eae End of Internal DB2 Information oe eee 


System Action: Utility processing is abnormally terminated. 


User Response: Modify the control statement. If this is a LOAD 
utility, decrease the number of INTO TABLE statements. If this 
is a RECOVER utility, either invoke the MERGE utility before 
submitting the RECOVER or decrease the number of table 
spaces specified in the table space list. 


Problem Determination: Review the utility control statements 
and output to determine the statement that was being proc- 
essed at the time of abend. . 
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00E4002B 


Explanation: The utility CHECK PENDING protocol has 
detected invalid parameters for the setting or resetting of the 
CHECK PENDING state. 


[ et a Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGCKP 


 Sacreee terete End of Internal DB2 Information ett er Set et 


System Action: The utility job is abended. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E4002D 


Explanation: This abend is issued as a result of an error other 
than RESOURCE UNAVAILABLE that was encountered while 
attempting to update a DB2 catalog for the setting or resetting 
of the CHECK PENDING state. 


Se ~ Internal DB2 Information ~ “| 


This abend reason code is issued by the following CSECT(s): 
DSNUGCKP 


aes End of Internal DB2 Information Beh tt 


System Action: An SVC dump is requested, the error flag in 
the DBA table is set on for the table space for which the CHECK 
PENDING state is being set or reset, and processing continues. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: Determine the reason for the catalog 
access error. This abend is accompanied by console message 
DSNU972I. See the problem determination for this message for 
a description of how processing is affected by this error. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31.. 


00E40030 


Explanation: A -DISPLAY UTILITY or -TERM UTILITY command 
has failed in the command subsystem. 


| 
| 


| 
| 


[~ ~~ Internal DB2 Information ~~ 


This abend reason code is issued by the following CSECT(s): 
DSNUGCCC 


[bee er cee End of Internal DB2 Information eee 


System Action: Command processing is terminated. For 
-TERM UTILITY, all previous actions taken by the command are 
backed out. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This error is accompanied by addi- 
tional messages and/or SVC dumps that identify the failure in 
the utility command subsystem. Refer to this manual under 
those messages and/or codes for additional problem determi- 
nation. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40033 


Explanation: Internal control blocks were scanned for internal 
IDs representing the SYSIBM.SYSUTIL table. No corresponding 
ID was found. 


ae ~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGDIS, DSNUGAGS, DSNUGSRI, DSNUGTER 


Dates eens End of Internal DB2 Information ete etE otal 


System Action: The utility job step is terminated, placing the 
utility in the stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 46. 


00E40034 


Explanation: The utility message generator was unable to 
obtain the requested storage. The available storage used to 
buffer messages produced by the database memory is full and 
a request to obtain more storage from subpool 229 failed. 


[ ~~~ Internal DB2 Information : 


This abend reason code is issued by the following CSECT(s): 
DSNUGMSG 


Lo End of Internal DB2 Information eee ll 


System Action: Utility processing abends. No SYSABEND 
dump or SVC dump is requested. 


00E40033 — 00E40040 


User Response: This abend occurs due to a system resource 
limit. It might be necessary to modify the utility control state- 
ment. 


If the abend occurs as a result of the LOAD utility, attempt to 
restart the job. If failure recurs, it might be necessary to 
change the discard limit or correct the situation that caused 
many error messages to be produced. 


If the abend occurs as a result of the REPAIR utility, change the 
beginning page number to the last page number printed plus 
one, or change the number of pages to be dumped to a smaller 
number. Resubmit the job. 


If the abend occurs as a result of the RECOVER INDEX utility, 
the unique index might have to be dropped and recreated as a 
non-unique index. If a unique index is required and the data 
contains a large number of duplicates, the duplicates must be 
reduced before attempting to recover the index again. 


Problem Determination: Refer to the prior error messages to 
determine how to correct the problem. 


00E40035 


Explanation: The START ACCESS FORCE command was 
issued when SYSUTIL was in a pending state which prohibits 
further processing. The pending state was either copy or 
recovery pending. 


: Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGTER 


eee End of internal DB2 Information el 


System Action: Abend 


User Response: Notify the system programmer so that the 
pending condition can be resolved. 


Operator Response: Notify the system programmer. 


System Programmer Response: Issue a display database to 
determine the state of SYSUTIL. If in copy pending, do a full 
image copy. If in recovery pending, use the recovery utility to 
recover SYSUTIL. 


Refer to Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: Use the display database command to 
determine the state of SYSUTIL. 


00E40040 


Explanation: An error has been returned from the DSNILREQ 
protocol during page level locking. This abend code is accom- 
panied by message DSNT500!I that explains the resource una- 
vailable condition. 


Internal DB2 Information mo ta 7 


This abend reason code is issued by the following CSECT(s): 
DSNUBBFR, DSNUCBFW, DSNUCBRP 


Le Pie End of internal DB2 Information yee et 


System Action: Utility processing is abended and the utility is 
placed in a stopped state. 


DB2 Codes 4-171 


00E40045 — 00E40070 


User Response: Correct the resource unavailable condition 
identified by the DSNT500I message. Then, either restart the 
utility from the last commit point or terminate the utility and 
restart it from the beginning. 


System Programmer Response: If the conditions identified in 
the DSNT500I message can not be corrected, determine the 
failing environment, and refer to Section 5 of Diagnosis Guide 
and Reference for symptom determination and failure analysis 
procedures. 


Problem Determination: Refer to the description for message 
DSNT500I under that message in this manual. 


Refer to Figure 4 in Appendix B, “Problem Determination” on 
page X-5 for an explanation of resource type codes. 


00E40045 


Explanation: A failure has occurred during an attempt to free 
storage. 


les eee Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUGSTB, DSNUGSTA 


(ee ee End of Internal DB2 Information fee ee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


Operator Response: An operator with SYSOPR authority can 
terminate the utility job step and free the resources (this may 
not be necessary). However, this should not be done until after 
the diagnostic environment has been established. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40051 
Explanation: Invalid OTYPE was passed to DSNUGMAP. 


ar ae Interna! DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGMAP 


ee ae End of Interna! DB2 Information een | 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


Operator Response: An operator with SYSOPR authority can 
terminate the utility job step and free up any resources (this 
may not be necessary). However, this should not be done until 
after the diagnostic environment has been established. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 
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Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40053 


Explanation: An invalid OBID of zero was found by the module 
that maps external object names to OBIDs. 


Internal DB2 Information eae geen a 


This abend reason code is issued by the following CSECT(s): 
DSNUGMAP 


eee End of Internal DB2 information ee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


User Response: Notify the system programmer. 


Operator Response: An operator with SYSOPR authority can 
terminate the utility job step and free any resources (this may 
not be necessary). However, this should not be done until after 
the diagnostic environment has been established. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: OBIDs are extracted from the DB2 
catalog. The OBID for a table space is found in the 
SYSIBM.SYSTABLESPACE table. The OBID for a table is found 
in the SYSIBM.SYSTABLES table. The OBID for a index is found 
in the SYSIBM.SYSINDEXES table. If the object exists, the 
OBID cannot be zero. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40070 


Explanation: Unable to open a utility work data set. The abend 
was issued to place the utility in the stopped state for review 
and correction. Resubmit the utility. 


internal DB2 Information ~~ a 


This abend reason code is issued by the following CSECT(s): 
DSNUGDSA 


a End of Internal DB2 Information ae 


System Action: The utility error message DSNUOS6E was 
issued. It identifies the the DD card associated with the DCB 
that could not be opened. The utility job step is placed in the 
stopped state. 


User Response: If the ddname is one you submitted, review 
and correct it. Then resubmit the job. If the ddname was not 
provided by you but by the system, consult the system pro- 
grammer. 


Operator Response: An operator with SYSOPR authority can 
terminate the utility to release the held resources (this may not 
be necessary). Refer to the appendix concerning submission of 
DB2 utilities in Appendixes of Administration Guide for work 
data set constraints. 


System Programmer Response: Correct the JCL, and resubmit 
the job. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


00E40071 


Explanation: An I/O error was encountered on a required 
OS/VS data set. An abend was issued to place the utility in a 
stopped state for review and correction. Resubmit the utility. 


[ — _ Jnternal DB2 Information et ‘| 


This abend reason code is issued by the following CSECT(s): 
DSNUGSDA 


| ar End of Internal DB2 Information epee Zl 


System Action: One of two utility error messages (DSNU032E 
or DSNU040I) is sent to the data set/device associated with the 
SYSPRINT DD card of the utility job step. The error message 
identifies the error and the data set in error. 


The utility is stopped at the beginning of the phase that used the 
OS/VS data set. 


User Response: [if the utility message was DSNU032E, the job 
can be restarted if an undamaged output data set is provided. 
Obtain an undamaged output data set, and restart the utility job 
step with the RESTART(PHASE) option. The job cannot be 
restarted if an unload data set, during the RELOAD phase of 
either the LOAD or REORG, is used as input instead of output. 


If utility message was DSNU040, determine the problem as 
described in Problem Determination. Then either resubmit the 
utility job using the RESTART option, or -TERM the utility job 
step. 


Operator Response: An operator with SYSOPR authority can 
terminate the utility and release any held resources (this may 
not be necessary). 


Problem Determination: Problem determination depends upon 
which error message was directed to the data set/device identi- 
fied by the SYSPRINT DD card. 


lf DSNUO32E was issued, an I/O error was encountered on a 
required utility work data set. The message describes the error 
and the data set in error. 


lf DSNU040I was issued, an error has occurred during BSAM 
access to the data set defined by the DD card specified in the 
message. The DECB provided as a hexadecimal string con- 
tains the ECB in the first four bytes. The first byte of the ECB 
contains status bits that indicate the cause of the error. Refer 
to the appropriate MVS publication for the meaning of the status 
bits. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40072 


‘Explanation: An internal error was encountered while proc- 
essing a BSAM data set. 


‘i a Internal DB2 information : | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSDA 


Upton End of Internal DB2 Information se te eel 


00E40071 — 00E40073 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00£40073 


Explanation: An internal error was encountered while proc- 
essing a BSAM data set. The utility in progress issued an 
internal read to a BSAM data set after end-of-file was returned 
for the data set. 


fe Internal DB2 Information : “| 


This abend reason code is issued by the following CSECT(s): 
DSNUGSDA 


| End of Internal DB2 Information i: 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40074 


Explanation: An internal error was encountered while proc- 
essing a BSAM data set. The utility in progress issued an 
internal point to a BSAM data set which is opened for write. 
Point is only valid for data sets opened for read. 


[ - SS Internal DB2 Information 2 ‘| 


This abend reason code is issued by the following CSECT(s): 
DSNUGSDA 


ee ee End of Internal DB2 Information _ 


System Action: The utility job step is terminated, placing the 
utility in the stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


DB2 Codes 4-173 


00E40079 — 00E40082 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 16, 31. 


00E40075 


Explanation: An end-of-data (EOD) has been encountered 
while attempting to reposition an input data set during the 
restart of a utility. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSDA 


sere End of Internal DB2 Information es 


System Action: Processing is abnormally terminated. A 
system dump is requested. 


User Response: Review the JCL and ensure that the input data 
set is correct. Further analysis may be necessary. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
60, 31. 


00E40079 


Explanation: A utility work data set has a block size that is too 
small to accommodate the data to be written. An abend is 
issued to place the utility job step in a stopped state. This 
allows the error to be reviewed and corrected, and the job step 
to be resubmitted. 


———— ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSDA 


lee ee End of Internal DB2 Information ent 


System Action: Utility error message. DSNUO38E is directed to 
the device/data set identified by the SYSPRINT DD card. The 
utility job step is placed in the stopped state. 


User Response: Delete the data set in error. Change the JCL 
so that the block size for the data set with the ddname nomi- 
nated in error message DSNUO38E is at least the indicated 
block size. Resubmit the utility job step with RESTART(PHASE) 
option. 


Problem Determination: Utility error message DSNU038E is 
directed to the device/data set identified by the SYSPRINT DD 
card. It gives the name of DD card that defines the data set with 
the inadequate block size and gives the minimum block size in 
bytes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40080 


‘Explanation: An error has been detected during utility. termi- 
nation cleanup. The DSNXKACC CLOSEALL protocol has 
returned an error. 
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| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGUCA 


(tree e End of Internal DB2 Information eee 


System Action: The utility job step is placed in the stopped 
state. 


Problem Determination: This abend code may be accompanied 
by a DSNT500I error message that may indicate a correctable 
problem. 


If the DSNT500! message has not been issued or if the problem 
can not be corrected, collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
§9, 60, 5, 31, 45. 


00E40081 


Explanation: The REORG utility has completed the UNLOAD 
phase while processing in a shared mode and has attempted to 
change to an exclusive mode for the RELOAD and subsequent 
phases. Utility processing has detected an internal error. 


| ~ Internal DB2 Information ~— sel 


This abend reason code is issued by the following CSECT(s): 
DSNUGSRX 


[ End of Internal DB2 Information | 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 46. 


00E40082 


Explanation: An error has been detected by utility serialization 
protocols. Protocols were issued in the wrong order. 


This is an internal error and cannot be corrected by the user. 


Internal DB2 Information SS 


This abend reason code is issued by the following CSECT(s): 
DSNUGSRX 


Vise ees End of Internal DB2 information eee | 


System Action: Utility processing is abnormally terminated and 
the utility is placed in a stopped state. An SDUMP is requested. 


User Response: The -TERM UTIL command may be issued to 
free resources held by the failing utility. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


00E40083 


Explanation: An error has been detected by utility serialization 
Pprotocois. Required parameters are missing. 


This is an internal error and cannot be corrected by the user. 


[ — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGSRI, DSNUGSRX 


Yeseeeteee cort se End of Internal DB2 Information ge otetiae 4 


System Action: Utility processing is abnormally terminated and 
the utility is placed in a stopped state. An SDUMP is requested. 


User Response: The -TERM UTIL command may be issued to 
free resources held by the failing utility. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


00E40085 


Explanation: A utility serialization LOCK or UNLOCK request 
has received an error from the RLM. Message DSNU0991 is 
issued prior to this abend code to provide information about the 
error. 


aa Internal DB2 Information ee AT ae 


This abend reason code is issued by the following CSECT(s): 
DSNUGDIS, DSNUGSRI, DSNUGSRX 


Th ete eek End of Internal DB2 Information ee cs el 


System Action: The utility job step is terminated. The utility is 
placed in a stopped state. 


User Response: Notify the system programmer. An attempt 
may be made to restart the utility. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command if the user does not wish to 
attempt to restart the utility. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and faiture analysis procedures. 


Problem Determination: This is an internal error. Refer to 
message DSNUO99I issued prior to this abend. 


00E40090 


Explanation: Utility processing is unable to invoke the desig- 
nated utility, because an internal! error has occurred. The spec- 
ified utility is not recognized by the utility job controller. 


00E40083 — 00E40096 


(_—- internal DB2 Information “4 | 


This abend reason code is issued by the following CSECT(s): 
DSNUGUTC, DSNUGDFL, DSNUGSRI 


NS fee Snes End of Internal DB2 Information pe ee ete 


System Action: The utility job step is terminated, placing the 
utility in the stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40091 


Explanation: Utility access path creation was invoked speci- 
fying an incorrect OBID. 


[ oo Internal DB2 Information ~ a 


This abend reason code is issued by the following CSECT(s): 
DSNUGACG 


[he eae peed’ End of Internal DB2 Information | 


System Action: The utility job step is terminated, placing the 
utility in the stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Probiem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40096 


Explanation: Utility access path creation has detected an 
invalid OBID. The specified value is too small, too large, or 
does not exist in the subsystem. 


| Internal DB2 Information ~~ as 


This abend reason code is issued by the following CSECT(s): 
DSNUGACC 


lee ee oe, End of Internal DB2 Information ese eet 


System Action: The utility job step that caused the function io 
be requested is abended. The utility job is placed in the stopped 
state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this may not be necessary). 


DB2 Codes 4-175 


00E400A0 — 00E40100 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E400A0 


Explanation: An error was detected while the internal structure 
to access the tables of a table space was being built. The table 
space had no tables. 


| ” — Internal DB2 Information ee 


This abend reason code is issued by the following CSECT(s): 
DSNUGACC 


—————— End of internal DB2 Information er 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the 
stopped state. 


Operator Response: An operator with SYSOPR authority can 
issue the -TERM UTILITY command to release the resources 
claimed by the stopped utility (this might not be necessary). 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


OOE4O0AF 


Explanation: A DSNGDALT macro invocation has returned a 
non-zero return code. An attempt to modify a DBD by setting 
the OBDIFIB bit on was unsuccessful. 


| ” ~~ {nternal DB2 Information ~ ee ee 


This abend reason code is issued by the following CSECT(s): 
DSNUGFIB, DSNURFIB 


[ End of Internal DB2 Information _ 


System Action: Processing is abnormally terminated. 


User Response: This abend may be due to an unavailable 
resource. Check for a DSNT500I message being issued prior to 
the abend. A dump will be suppressed in this case. {f no 
RESOURCE UNAVAILABLE condition is indicated, notify the 
system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


4-176 DB2 Messages and Codes 


00E400B0 


Explanation: | Utilities invocation of CREATE THREAD has 
ended abnormally. 


| Internal DB2 Information aa | 


This abend reason code is issued by the following CSECT(s): 
DSNUGBAC, DSNUGUTC 


[End of Internal DB2 Information 


System Action: The utility job step is terminated. No record of 
the utility job step remains in the system. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E400C0 


Explanation: A -STOP DB2 MODE(FORCE) command has been 
entered while a utility was executing, or a -STOP DB2 
MODE(QUIESCE) command has been entered while a utility 
with multipie input statements was executing and the current 
input statement execution has completed. 


| Internal DB2 Information ~~ : a 


This abend reason code is issued by the following CSECT(s): 
DSNUGPRE, DSNUGUTC 


Ei Arcee hes End of Internal DB2 Information ee 


System Action: Utility processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the reason that the 
-STOP DB2 command was issued. After DB2 has been started 
again, the utility job may be restarted. 


00E40100 


Explanation: The buffer manager (BM) subcomponent of DB2 
failed during execution of the DSNBGETP macro. 


[ a Internal DB2 Information ~ eas | 


This abend reason code is issued by the following CSECT(s): 
DSNUBBFR, DSNUCBFW, DSNUBCL5, DSNUCRVA 


[ee es End of internal DB2 Information see 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40101 


Explanation: The buffer manager (BM) subcomponent of DB2 
failed during execution of the DSNBSETW macro. 


ie 7 Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUBBFR 


[| End of Internal DB2 Information ______——— 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40102 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNICCOB macro. 


= Internal DB2 Information ~——————S 


This abend reason code is issued by the following CSECT(s): 
DSNUAHR2 


lies End of Internal DB2 Information Sd ase 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Probiem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40103 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNICCUB macro. 


= — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUADP1, DSNUADP2 


{End of internal DB2 Information ___ | 


00E40101 — 00E40105 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT5001. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the jast commit point or terminate the utility and 
start it again from the beginning. !f DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: [f the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40104 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIDISP macro. 


Internal DB2 Information : aaa 1 


This abend reason code is issued by the following CSECT(s): 
DSNULOG1 


ie cece End of Internal DB2 Information eee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40105 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIDLET macro. 


io ~~ internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUADP1, DSNUADP2, DSNURRRI 


Lo End of internal DB2 Information pate 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT5001. An SDUMP may be. 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNTS00! was not issued, 


DB2 Codes 4-177 


00E40106 — 00E40109 


register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: if the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page. X-5: 1, 59, 60, 
5, 31, 45. 


00E40106 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNILRDO macro. 


| | internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUCLVL, DSNUCRVL 


as End of Internal DB2 Information ee ee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500I. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500! in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40107 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIISRT macro. 


| Internal DB2 Information i ——- | 


This abend reason code is issued by the following CSECT(s): 
DSNUAHR2 : 


ie os ht End of Internal DB2 Information see 


4-178 DB2 Messages and Codes 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility fromthe last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40108 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNINEXH macro. 


| Internal DB2 Information —— | 


This abend reason code is issued by the following CSECT(s): 
DSNUADP1, DSNUADP2, DSNUAHR2 


Pees ok End of Internal DB2 Information a ee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. !f DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the foliowing diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40109 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIPGER macro. 


| Internal DB2 Information ~~ ep a 


This abend reason code is issued by the foliowing CSECT(s): 
DSNUCRVT, DSNUCRVA 


(ae eee End of Interna! DB2 Information ee, 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!1. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT5001 message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- - 
grammer. 


System Programmer Response: !f the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. See the secondary reason code from register 2, also in 
this manual. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 

Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
§, 31, 45. 


00E4010A 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIPSCB macro. 


= ~~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUCLVL, DSNUCLVS, DSNUCRVI 


eee ees End of Internal DB2 Information ore et 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
‘refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500! in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E4010A — 00E4010C 


00E4010B 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIPZOP macro. 


[ee Internal DB2 Information Z | 


This abend reason code is issued by the following CSECT(s): 
DSNUBBFR, DSNUCLRS, DSNUCLVS, DSNUCRVT 


eee eee End of Internal DB2 Information bg el 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500I. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. !f DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500! in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E4010C 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIREPL macro. 


a — internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUAHR2 


ae eee End of Internal DB2 Information inst get tat 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500i. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT5001 was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 


DB2 Codes 4-179 


00E4010D — 00E40110 


Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E4010D 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNISETH macro. 


[ > "= Internal DB2 Information i. a | 


This abend reason code is issued by the following CSECT(s): 
DSNUADP1, DSNUADP2, DSNUAHR2, DSNUBCL5, DSNURRRI 


eee End of Internal DB2 Information ee | 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT5001 was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
§, 31, 45. 


00E4010E 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNISRCF macro. 


| — Internal DB2 Information ae De 


This abend reason code is issued by the following CSECT(s): 
DSNUCRVT 


Poe se rae End of Internal DB2 Information eee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500I. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
Start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified- 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 
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Problem Determination: See message DSNT500I in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
§, 31, 45. 


00E4010F 


Explanation: The data manager subcomponent of DB2 failed 
during execution of the DSNIURBA macro. 


| 7 : Internal DB2 Information sy 


This abend reason code is issued by the following CSECT(s): 
DSNULOG1 


ee End of Internal DB2 Information ee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!I. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT5001 was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500I in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40110 


Explanation: The data space manager subcomponent of DB2 
failed during execution of the DSNPRSPS macro. 


Internal DB2 Information tl 


This abend reason code is issued by the following CSECT(s): 
DSNUCLRS, DSNUCRVA 


| End of Internal DB2 Information 


System Action: The utility job is abended. DSM provides diag- 
nostic information. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40111 


Explanation: The data space manager subcomponent of DB2 
failed during execution of the DSNPXTND macro. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUCBFW 


—————a End of Internal DB2 Information es 


System Action: The utility job is abended. DSM provides diag- 
nostic information. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40112 
Explanation: DSNUGMAP, a utilities program, has failed. 


| ; Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUCBFW 


ee End of Internal DB2 Information ees | 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the foliowing diagnostic items Jisted in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40113 


Explanation: The data space manager subcomponent of DB2 
failed during execution of DSNPRSET. 


. Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUCRUA 


ere End of Internal DB2 Information ee | 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed on the 
stopped state. 


00E40111 — 00E40116 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40114 


Explanation: The data manager subcomponent of DB2 failed 
during execution of DSNICLPS. 


| — internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUCLRS, DSNUCRVA 


ste aes End of Internal DB2 Information a ee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
State. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40115 


Explanation: The data manager subcomponent of DB2 failed 
during execution of DSNIUSTP. 


é oe anes ee Internal DB2 Information ~ ii 


This abend reason code is issued by the following CSECT(s): 
DSNUCLVE, DSNUCRVA 


Phe oe End of internal DB2 Information ee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40116 
Explanation: Either DSN3SYNC or DSN3ABRT failed. 


DB2 Codes 4-181 


00E40117 — 00E40120 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUBCLO, DSNUBICO, DSNUCRVA, DSNUCRVO 


eee ee End of Internal DB2 Information pee reer | 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40117 
Explanation: DSNURBXB, a utilities module, failed. 


eo ~ Internal DB2 Information ~~ a ~ 


This abend reason code is issued by the following CSECT(s): 
DSNUCRVI 


Uae End of Internal DB2 Information teen tee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40118 


. Explanation: The data space manager subcomponent of DB2 
failed during execution of the DSNPGNPO macro. 


[ Internal DB2 Information nee 


This abend reason code is issued by the following CSECT(s): 
DSNUCRVA 


| _sEnd of internal DB2 information ___——_| 


System Action: The utility job is abended. The DSM provides 
any required diagnostic information, such as messages, dumps, 
or log records. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


4-182 DB2 Messages and Codes 


00E40119 


Explanation: During recovery, a full image copy was not found 
for DB2 directory or DB2 catalog table space. 


| Internal DB2 Information = | 


This abend reason code is issued by the following CSECT(S): 
DSNUBCLO 


le ee eee End of Internal DB2 Information ety oar Tat 


System Action: The utility job is abended. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: When the recovery of the DB2 catalog 
or directory table space is requested, make sure that a full 
image copy has been taken first. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 14, 31. 


OOE4011A 


Explanation: An error has occurred in the RECOVER utility 
while applying log with log RBA=0O. 


internal DB2 Information ~_ ae | 


This abend reason code is issued by the following CSECT(S): 
DSNUCLVL, DSNUCRVL 


eres earn End of Internal DB2 Information ete 


System Action: The utility job is abended. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: Make sure the SYSLGRNG table 
space is not empty before applying the log. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 5, 31, 52. 


00E40120 


Explanation: A delete of SYSLGRNG information has failed 
during -TERM UTILITY command processing for a REORG utility 
in the RELOAD phase. 


— eo ee Internal DB2 Information ; ” f * | 


This abend reason code is issued by the following CSECT(s): 
DSNUBCOP 


Litem ae End of Internal DB2 Information re | 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500I. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500i was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Probiem Determination: See message DSNT500! in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40121 


Explanation: A RDJFCB macro invocation has returned a non- 
zero return code. 


[- Se Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUBCKB 


ee End of Internal DB2 Information | 


System Action: Processing is abended. 


User Response: This is probably a user error. A DD card may 
be missing or specified incorrectly. If the DD cards appear to 
be correct, there may be another cause of the error and you 
should notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: The DD card referred to by the 
COPYDDN Utility keyword may be missing or specified incor- 
rectly. If COPYDDN was not specified, a DD card with a default 
name equal to SYSCOPY must be present in the job step. 


00E40163 


Explanation: An error has been detected during activity history 
recording insert of SYSIBM.SYSLGRNG. 


| Internal DB2 Information ~ = 


This abend reason code is issued by the following CSECT(s): 
DSNUAHR2 


a ee ee End of Internal DB2 Information he | 


System Action: Processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


00E40121 — 00E40166 


Problem Determination: This is an internal! error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1,59, 60, 5, 31, 45. 


00E40164 


Explanation: An error has been detected during activity history 
recording update of SYSIBM.SYSLGRNG. 


[ ~~ Interna! DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUAHR2 


eee End of Internal DB2 information fe 4 


System Action: Processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40165 


Explanation: An error has been detected during an execution 
unit switch while performing application history recording or 
drop processing. 


internal DB2 Information ~~ —— is 


This abend reason code is issued by the following CSECT(s): 
DSNUAHR1, DSNUADP1 


{| End of Internal DB2 Information | 


System Action: Processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59,60, 5, 31, 45. 


00E40166 


Explanation: A delete of SYSIBM.SYSLGRNG information has 
failed during DROP processing. 


| Internal DB2 Information ae a 


This abend reason code is issued by the following CSECT(s): 
DSNUADP2 


(oe aoe End of Internal DB2 Information ees 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


DB2 Codes 4-183 


00E40167 — 00E40190 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and either restart the 
utility from the last commit point or terminate the utility and 
Start it again from the beginning. If DSNT500i was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40167 


Explanation: A delete of SYSIBM.SYSCOPY information has 
failed during DROP processing. 


| sae 2 Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUADP1 


heer End of Internal DB2 Information Se, 


System Action: Processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40168 


Explanation: The buffer manager (BM) subcomponent of DB2 
faited during the execution of the DSNBPFPP macro. 


- ~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUCRVA 


He eee End of Internal DB2 Information ee ee 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


Problem Determination: This is a DB2 subsystem internal 
error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


4-184 DB2 Messages and Codes 


00E40169 


Explanation:. An incremental image copy was requested. The 
image COPY utility was attempting to read the most recent ful! 
image COPY/REORG/LOAD record from the SYSIBM.SYSCOPY 
table. However, an unexpected error return code was returned 
by the data manager (DM) subcomponent of DB2 during exe- 
cution of the DSNISETH macro. 


| Internal DB2 Information - | 


This abend reason code is issued by the following CSECT(s): 
DSNUBBFR 


aoe ee End of Internal DB2 Information fed vnc 


System Action: The utility job step that caused the function to 
be requested is abended. The utility job is placed in the stopped 
state. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


Problem Determination: This is a DB2 subsystem internal 
error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40189 


Explanation: An error has been detected while inserting 
records from SYSIBM.SYSCOPY. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUBINS 


eee End of Internal DB2 Information eee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500I. An SDUMP may be 
requested. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point, or terminate the utility and 
start it again from the beginning. If DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment, and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: Refer to “Section 3. DB2 Messages” 
on page 3-1 for a description of message DSNT500I. Refer to 
“Section 4. DB2 Codes” on page 4-1 for a description of the 
secondary reason code shown in register 2. 


00E40190 


Explanation: An error has been detected while scanning 
SYSIBM.SYSCOPY. 


| Internal DB2 Information : 3) 


This abend reason code is issued by the following CSECT(s): 
DSNUMDEL 


ete End of Internal DB2 Information ee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
requested. 


User Response: Correct the resource unavailable condition 
identified by the DSNT500! message and either restart the utility 
from the last commit point or terminate the utility and start it 
again from the beginning. If DSNT500! was not issued, register 
2 contains a secondary DB2 reason code that will give more 
information about the problem. 


System Programmer Response: if the condition identified can 
not be corrected, determine the failing environment, and refer 
to Section 5 of Diagnosis Guide and Reference for symptom 
determination and failure analysis procedures. 


Problem Determination: Refer to the description for message 
DSNT500!I under that message number in this manual. Refer to 
the description of the secondary reason code from register 2 
also in this manual. 


00E40191 


Explanation: An error has been detected while deleting 
records from SYSIBM.SYSCOPY. 


| internal DB2 Information ~—_———_—S—S—<—~;7«7; | 


This abend reason code is issued by the following CSECT(s): 
DSNUMDEL 


ee ee End of internal DB2 Information es 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500I. An SDUMP may be 
requested. 


User Response: Correct the resource unavailable condition 
identified by the DSNT500I message and either restart the utility 
from the last commit point or terminate the utility and start it 
again from the beginning. If DSNTSOOI was not issued, register 
2 contains a secondary DB2 reason code that will give more 
information about the problem. 


System Programmer Response: lf the condition identified can 
not be corrected, determine the failing environment, and refer 
to Section 5 of Diagnosis Guide and Reference for symptom 
determination and failure analysis procedures. 


Problem Determination: Refer to the description for message 
DSNT500! under that message number in this manual. Refer to 
the description of the secondary reason code from register 2 
also in this manual. 


00E40192 


Explanation: An invalid call to DSNULOG1 has been detected, 
when a partial recovery function in DSNULOG1 was invoked. 
The passed parameter is not a TOCOPY or TORBA to 
SYSCOPY, SYSUTIL, or DSNDBO1. 


00E40191 — 00E40201 


- ~~ Internal DB2 Information ~ 


This abend reason code is issued by the following CSECT(s): 
DSNULOG1. 


bee End of Internal DB2 Information be ee 


System Action: Utility processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ-. 
ment, and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis. 


Problem Determination: This is an internal error. 


00E40193 


Explanation: RECOVER INDEX utility processing was 
attempting to retrieve catalog table information and an error 
was detected during the retrieving process. 


[ internal DB2 Information ~ aia 


This abend reason code is issued by the following CSECT(s): 
DSNUKINT 


lle cut eee End of Internal DB2 Information ee | 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage and an SVC dump of the database services 
storage are requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. See 'Utilities Reason Codes! (X'E4'). 


Problem Determination: This is an internal error. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Collect the following diagnostic items listed in Appendix 8B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40201 


Explanation: RUNSTATS has been unable to reposition and 
continue processing after a COMMIT. 


| internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUSIDX, DSNUSTBL 


a eee End of Internal DB2 Information Bete 2! 


System Action: Utility processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures.. 


Problem Determination: This is an internal error. Coilect the 
following diagnostic items listed in Appendix B, “Problem 
Determination” on page X-5:. 1, 59, 60, 5, 31, 45. 


DB2 Codes 4-185 


00E40202 — 00E40207 


00E40202 


Explanation: An error has been detected while scanning a 
table space or index during RUNSTATS processing. 


| ae Internal DB2 Information = 


This abend reason code is issued by the following CSECT(s): 
DSNUSIDX, DSNUSTBL 


Vee ek End of Internal DB2 Information Bate Fore sel 


System Action: Utilities processing is abended. 


User Response: If message DSNT500I was issued, assure that 
the indicated resource is available and resubmit the job, other- 
wise notify the system programmer. 


System Programmer Response: If message DSNT500I was 
issued, refer to the description of the message in “Service Con- 
troller and Installation Messages (DSNT...)” on page 3-121, oth- 
erwise, this is an internal error. Refer to Section 5 of Diagnosis 
Guide and Reference for symptom determination and failure 
analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40204 


Explanation: An error has been detected while attempting to 
locate the PBO contro! block for a table space partition. 


Internal DB2 Information = 


This abend reason code is issued by the following CSECT(s): 
DSNUSTBL 


lip End of Internal DB2 Information ene. | 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40205 


Explanation: An error has been returned from COMMIT or 
ABORT processing during RUNSTATS. 


ae —  Jnternal DB2 Information ~ _ = = 


This.abend reason code is issued by the following CSECT(s): 
DSNUSDRB, DSNUSIDX, DSNUSTBL 


Peete ees End of Internal DB2 Information | 


System Action: Utilities processing is abended. 


4-186 DB2 Messages and Codes 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40206 


Explanation: An error has been detected while updating the 
statistics in the SYSIBM.SYSCOLUMNS Catalog table. 


7 as Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUSCT1, DSNUSUCO 


[Went re toot End of Internal DB2 Information a 


System Action: Utilities processing is abnormally terminated. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. Examine 
register 2 to find the secondary reason code. Refer to this sec- 
ondary reason code found in this manual. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40207 


Explanation: An error has been detected while updating the 
statistics in the SYSIBM.SYSINDEXES Catalog table. 


| ~~ Internal DB2 Information ~~ s+ 


This abend reason code is issued by the following CSECT(s): 
DSNUSCT2, DSNUSUIX 


eee eos End of Internal DB2 information ee 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. Refer to 
Figure 4in Appendix B, “Problem Determination” on page X-5 
for an explanation of resource type codes. Examine register 2 
to find the secondary reason code. Refer to the description of 
this secondary reason code found in this manual. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40208 


Explanation: An error has been detected while updating the 
statistics in the SYSIBM.SYSINDEXPART Catalog table. 


[oe - Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUSCT3, DSNUSUIP 


[ea oe eek End of Internal DB2 Information Sot eal 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


‘Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. Examine 
register 2 to find the secondary reason code. Refer to the 
description of this secondary reason code found in this manual. 


Collect the foliowing diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40209 


Explanation: An error has been detected while updating the 
statistics in the SYSIBM.SYSTABLEPART Catalog table. 


‘i. . — Internal DB2 Information SS a | 


This abend reason code is issued by the following CSECT(s): 
DSNUSCT4, DSNUSUTP 


|, End of Internal DB2 Information ee | 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. Examine 
register 2 to find the secondary reason code. Refer to the 
description of this secondary reason code found in this manual. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40210 


Explanation: An error has been detected while updating the 
statistics in the SYSIBM.SYSTABLES Catalog table. 


a ~ Internal DB2 Information ~~ 7 


This abend reason code is issued by the following CSECT(s): 
DSNUSCT5, DSNUSUTB 


a ae End of Internal DB2 information eee 


System Action: Utilities processing is abended. 


00E40208 — 00E40212 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. Examine 
register 2 to find the secondary reason code. Refer to the 
description of this secondary reason code found in this manual. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40211 


Explanation: An error has been detected while updating the 
statistics in the SYSIBM.SYSTABLESPACE Catalog table. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUSCT6, DSNUSUTS 


ae End of Internal DB2 Information ete tee 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. Examine 
register 2 to find the secondary reason code. Refer to the 
description of this secondary reason code found in this manual. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40212 


Explanation: A RESOURCE UNAVAILABLE condition has been 
detected while attempting to access a catalog table during 
RUNSTATS processing. 


[ — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUSVAL 


Ve aseiet tae End of Internal DB2 Information o eoese oe 22 


System Action: Utility processing is abended. The abend will 
be accompanied by message DSNT5001. An SDUMP may be 
taken. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and restart the utility. 
lf DSNT500! was not issued, register 2 contains a secondary 
DB2 reason code that will give more information about the 
problem. Notify the system programmer. 


Operator Response: Notify the system programmer. 


DB2 Codes 4-187 


00E40220 — 00E40223 


System Programmer Response: [If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Refer to Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manuai. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40220 


Explanation: An error has been detected while accessing the 
SYSIBM.SYSSTOGROUP catalog table during STOSPACE proc- 
essing. 


Internal DB2 Information = | 


This abend reason code is issued by the following CSECT(s): 
DSNUTSSA 


(inte ea ot End of Internal DB2 Information eee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001I in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40221 


Explanation: An error has been detected while accessing the 
SYSIBM.SYSTABLEPART catalog table. 


| Internal DB2 Information ~ " | 


This abend reason code is issued by the following CSECT(s): 
DSNUTSSA, DSNUKINP 


ete to oe End of Internal DB2 Information eee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


4-188 DB2 Messages and Codes 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500!I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: [if the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40222 


Explanation: An error has been detected while accessing the 
SYSIBM.SYSINDEXPART catalog table during STOSPACE proc- 
essing. 


| na as internal DB2 Information i | 


This abend reason code is issued by the following CSECT(s): 
DSNUTSSA 


[Ss End of internal DB2 information | 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT5001 message and either restart the 
utility from the last commit point or terminate the utility and . 
start it again from the beginning. If DSNT500i was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: [!f the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40223 


Explanation: An error has been detected while accessing the 
SYSIBM.SYSTABLESPACE catalog table. 


| Internal DB2 Information ——- | 


This abend reason code is issued by the following CSECT(s): 
DSNUTSSA, DSNUKINP 


———— End of Internal DB2 Information lee eon 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500I. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. If DSNT500I was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT500I in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40224 


Explanation: An error has been detected while accessing the 
SYSIBM.SYSINDEXES catalog table during STOSPACE proc- 
essing. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUTSSA 


a are End of Internal DB2 Information ee 


System Action: Utility processing is abended. The abend may 
be accompanied by message DSNT500!. An SDUMP may be 
taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500I message and either restart the 
utility from the last commit point or terminate the utility and 
start it again from the beginning. {f DSNT500! was not issued, 
register 2 contains a secondary DB2 reason code that will give 
more information about the problem. Notify the system pro- 
grammer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, also 
in this manual. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for symptom determination and failure analysis proce- 
dures. Collect the following diagnostic items listed in 
Appendix B, “Problem Determination” on page X-5: 1, 59, 60, 
5, 31, 45. 


00E40225 


Explanation: An error has been detected by DSNPSCAT during 
STOSPACE processing. 


00E40224 — 00E40302 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUTSSA 


| End of internal DB2 information __._———d 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40300 


Explanation: An error occurred in END INDEX LOAD proc- 
essing following a sequence of index entry loads. 


| =—— internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNURBXA 


[ents Sees ore End of internal DB2 Information eee | 


System Action: The utility job is abended. A SYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40302 


Explanation: An error occurred while attempting to force a 
page set closed. 


— Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNURBXA, DSNURBXB, DSNURCLP 


ee End of Internal DB2 Information id 


System Action: The utility job is abended. A SYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


DB2 Codes 4-189 


00E40303 — 00E40307 


00E40303 


Explanation: An attempt was made to access the 
SYSIBM.SYSINDEXES catalog table to retrieve the NAME, 
CREATOR, TBNAME and TBCREATOR columns. An error was 
returned from the DSNXKACC protocol used to access 
SYSIBM.SYSINDEXES. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): | 
DSNUGIXN, DSNUKINT 


(poeta eee: set End of Internal DB2 Information ee eee 


System Action: The utility job is abnormally terminated. 
Unless a resource unavailable condition was indicated, a 
SYSABEND dump of batch storage is requested. 


User Response: If a resource unavailable message was 
issued, refer to the description for that message. If the unavail- 
able resource becomes available, the utility step is restartable. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures if the 
error cannot be corrected. 


Problem Determination: This might be an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40304 


Explanation: An error occurred during key/RID pair delete 
processing for a nonclustering index. 


———. ~~ {Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNURBXA 


ene era End of Internal DB2 Information _ 


System Action: The utility job is abnormally terminated. A 
SYSABEND dump of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40305 


Explanation: An error occurred during the reset of an index 
space or table space page set or page set partition. 


| 
ae Internal DB2 Information | | 


This abend reason code is issued by the following CSECT(s): 
DSNURBXA, DSNUGRST 


fiat co. on tn End of internal DB2 Information Bo cl 


4-190 DB2 Messages and Codes 


System Action: The utility job is abnormally terminated. The 
abend may be accompanied by message DSNT5001. An SDUMP 
may be taken. 


User Response: Correct the RESOURCE UNAVAILABLE condi- 
tion identified by the DSNT500! message and either restart the 
utility or terminate the utility and submit it again. If DSNT500! 
was not issued, register 2 contains a secondary DB2 reason 
code that will give more information about the problem. Notify 
the system programmer. 


System Programmer Response: If the condition identified 
cannot be corrected, determine the failing environment and 
refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: See message DSNT5001 in this 
manual. See the secondary reason code from register 2, and 
also refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40306 


Explanation: An error occurred during a locate or create PSCB 
for a table space or index space page set. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNURBXB 


rs End of Internal DB2 Information be ee El 


System Action: The utility job is abnormally terminated. A 
SYSABEND dump of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40307 


Explanation: An error occurred during the creation of a 
dynamic cursor block (CUB) for a table space or index space 
page set. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNURBXB 


Wee gee te End of Internal DB2 Information ete eee 


System Action: The utility job is abnormally terminated. A 
SYSABEND dump of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40308 


Explanation: An error occurred while attempting to allocate or 
deallocate storage for the table space record buffer. 


Internal DB2 Information 


This abend reason Code is issued by the following CSECT(s): 
DSNURBXB 


es End of Internal DB2 Information een 


System Action: The utility job is abnormally terminated. A 
SYSABEND dump of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40309 


Explanation: An error occurred during the construction of an 
index entry. The error occurred while reading the table space 
record, while extracting the key from the table space record, or 
while connecting the entry into the index. 


a ~~~ _ Internal DB2 Information ~ od 


This abend reason code is issued by the following CSECT(s): 
DSNURBXB 


eee ee End of Internal DB2 Information | 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40310 


Explanation: An error occurred during the restart of a LOAD or 
REORG utility execution. An appropriate error message is 
issued. 


—_ ~~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNURELD, DSNURULD 


eles End of Internal DB2 Information Bee es 


System Action: The utility is abended. 


00E40308 — 00E40313 


User Response: Respond to the error message issued prior to 
the abend by making the correction in the input as indicated. 
Then restart the LOAD or REORG utility execution. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
59, 60, 5, 31, 45. 


00E40311 


Explanation: An error occurred during commit processing. 


r= Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUKO01, DSNUPREC, DSNUPTSS, DSNURELD, DSNURENF, 
DSNURULD, DSNURWBF 


Eee End of Internal DB2 Information sou gece tie onl 


System Action: The utility is abended. A SYSABEND dump of 
batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40312 


Explanation: An error occurred during abort processing. 


| Internal DB2 Information ~ eens aN 


This abend reason code is issued by the following CSECT(s): 
DSNURELD, DSNURULD 


lige ie Seo End of Internal DB2 Information ee ee 


System Action: The utility is abended. A SYSABEND dump of 
batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40313 


Explanation: An error occurred while the first or next key entry 
was being retrieved from an index. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUKGET, DSNURCRI, DSNURFBI 


_——— ae End of Internal DB2 Information eee 


DB2 Codes 4-191 


00E40314 — 00E40318 


System Action: The utility job is abended. ASYSABEND dump | 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- | 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


| 


Coliect the following diagnostic items listed in Appendix B, | 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40314 


Explanation: An error occurred while repositioning the cursor 
block (CUB) to the last index entry that was retrieved. 


ae ~~ Internal DB2 Information 


This abend reason Code is issued by the following CSECT(s): 
DSNURFBI 


Use End of Internal DB2 Information mere 2 


System Action: The utility job is abended. A SYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page: X-5: 1, 59, 60, 5, 31, 45. | 


00E40315 


Explanation: An error occurred while repositioning the main 
cursor block (CUB). The error occurred at the location defined 
by the record identifier (RID) of the last table space record that 
was retrieved. 


Et = =. Ng Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNURFBR 


eee End of Interna! DB2 Information fp Se Bok cael 


System Action: The utility job is abended. A SYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. | 


00E40316 


Explanation: An error occurred while the first or next record 
entry was being retrieved from a table space. 


4-192 DB2 Messages and Codes 


“~ {Internal DB2 Information : 


This abend reason code is issued by the following CSECT(s): 
DSNURFBR, DSNURWES, DSNUKICK, DSNUCRUL 


[snd of Internal DB2 Information _.__———_—id 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40317 


Explanation: An object descriptor block (OBD) could not be 
found for the OBID associated with the object descriptor. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUnnnn, where 'nnnn' is the CSECT name identifier given in 
VRARRKS of the VRA in the SOWA. DSNUnnnon is the full CSECT 
name given in the dump title. 


Die ort os End of Internal DB2 Information pees | 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40318 


Explanation: An error occurred while preparing for or ending a 
series of data record loads or while attempting a data record 
load. 


i Internal DB2 Information ~~ : | 


This abend reason code is issued by the following CSECT(s): 
DSNURWBF, DSNUGTER 


ere: End of Internal DB2 Information 35 | 


System Action: The utility job is abended. A SYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40319 


Explanation: An error occurred while retrieving information 
from the SYSIBM.SYSTABLES catalog table. 


i — fnternal DB2 Information ~~ "tT 1 


This abend reason code is issued by the following CSECT(s): 
DSNURWIR 


ene End of Internal DB2 Information ae 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40320 


Explanation: A failure occurred while attempting to restart the 
RELOAD phase of the LOAD or REORG utility. 


feo 5 — Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNURWUC 


Ls End of Internal DB2 Information ______— 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40321 


Explanation: An error occurred while retrieving information 
from the SYSIBM.SYSCOLUMNS catalog table. 


a Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUKINE, DSNUROFL, DSNUCBRK 


Let case Sh End of Internal DB2 Information ea antes atl 


System Action: The utility job is abended. A SYSABEND dump 
of batch storage is requested. 


User Response: Notify the system programmer. 


00E40319 — 00E40323 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40322 


Explanation: An error occurred while attempting to add an 
entry to an index. 


Se Internal DB2 Information ~~ : | 


This abend reason code is issued by the following CSECT(s): 
DSNURBXA 


Oe End of Internal DB2 tnformation _ 


System Action: Processing of the index for which the error 
occurred is terminated. The index is internally identified as an 
unavailable resource. A utility error message identifies the 
index for which the error occurred. An SVC dump of the data- 
base services storage is requested but will be suppressed if a 
previous resource unavailable message has been issued to 
document the condition. The processing of index entries for 
other indexes proceeds. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Probiem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40323 


Explanation: An error occurred during the execution of a 
LOAD or REORG utility. Prior to this abend, error messages 
identifying the specific problem were issued. The abend is 
issued so that work data sets, which will be needed if the utility 
is restarted, are saved. 


[ : Internal DB2 Information ue ne | 


This abend reason code is issued by the following CSECT(s): 


DSNURELD DSNURWBF DSNURBXD 
DSNURVIX DSNURENF 


ee ae End of Internal DB2 Information ae | 


System Action: Utility processing is abended. No SYSABEND 
dump or SVC dump is requested. 


User Response: Respond to the error messages issued prior 
to the abend. Correct the input and either -TERM the utility and 
resubmit it or resubmit the utility with the RESTART parameter. 
Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis. 


Problem Determination: When work data sets are used and the 
disposition is MOD, DELETE, and CATLG, 

(DISP = (MOD,DELETE,CATLG)), this abend still allows you to 
restart the utility. Refer to the prior error messages to deter- 
mine how to correct the problem. 


DB2 Codes 4-193 


00E40324 — 00E40335 


00E40324 


Explanation: An error occurred during the construction of an 
index entry. The error occurred while extracting the key from 
the table space. 


| Internal DB2 Information ~— = + 


This abend reason code is issued by the following csect(s): 
DSNURBXB 


(ee End of Internal DB2 Information peat tne) 


System Action: The utility job is abended. A SYSABEND dump 
of batch storage and an SVC dump of the database services 
storage are requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40325 


Explanation: An error occurred during the construction of an 
index. The error occurred while loading the index entries into 
the index pageset. 


Internal DB2 Information ~~ a 


This abend reason code is issued by the following csect(s): 
DSNURBXB 


[sees oe End of Internal DB2 Information eee | 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage and an SVC dump of the database services 
storage are requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40326 


Explanation: An error occurred during the construction of an 
index. The error occurred during sort. 


ha ae Internal DB2 Information 


This abend reason code is issued by the following csect(x): 
DSNURBXB 


a End of Internal DB2 Information ee 


4-194 DB2 Messages and Codes 


System Action: The utility job is abended. ASYSABEND dump 
of batch storage and an SVC dump of the database services 
storage are requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31. 


00E40333 


Explanation: An error occurred while attempting a forced write 
of RELOAD phase data buffers. 


| Internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNURFIS 


oer End of Internal DB2 Information Pete te eel 


System Action: RELOAD phase processing is terminated. An 
SDUMP of the ADMF address space will be requested. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


00E40334 


Explanation: LOAD or REORG utility processing was 
attempting to retrieve COLUMN information from 
SYSIBM.SYSFIELDS when when an error was detected. 


| ~~ Internal DB2 Information ~~ ee 4 


This abend reason code is issued by the following CSECT(s): 
DSNURFIT, DSNURWIS 


er End of Internal DB2 Information siete Ase 


System Action: Utility processing is abended. An SDUMP is 
requested unless this abend is accompanied by a DSNT500! 
message written to the SYSPRINT data set. 


User Response: Notify the system programmer. 


System Programmer Response: Correct the indicated error if 
possible and resubmit the terminated utility job with the 
RESTART parameter. If the problem can not be corrected, refer 
to Section 5 of Diagnosis Guide and Reference for symptom 
determination and failure analysis. 


Problem Determination: If this abend is due to a resource una- 
vailable, the DSNT500I message will provide sufficient problem 
determination and correction information. Register 2 will 
contain a secondary reason code that may provide additional 
information. 


00E40335 


Explanation: An error has been detected while attempting to 
read a row from the SYSIBM.SYSRELS table. 


| 
| 


| Internal DB2 Information ~——————~— “| 


This abend reason code is issued by the following csect(s): 
DSNUGRLN 


bat tte End of Internal DB2 Information | 


System Action: The utility job is abended. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 


symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 31. 


00E40336 


Explanation: LOAD or REORG utility used the DSNXIFPS pro- 
tocol to invoke a field procedure for encode or decode and an 
error code was returned that indicates a DB2 internal error. 


= — ~~ Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNURFBR, DSNURWBG 


eit eh End of Internal DB2 Information Bete eres) 


System Action: Utility processing is abended. An SDUMP is 
requested. 


User Response: Notify the system programmer. 


Problem Determination: This is an internal error. Refer to 
Section 5 of Diagnosis Guide and Reference for symptom deter- 
mination and failure analysis. 


00E40340 


Explanation: The LOAD or REPAIR utility used the DSNXVCCR 
protocol to invoke a conversion routine for a date/time data 
type. An error code was returned that indicates a DB2 internal 
error. 


tee ee a ~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNURWBG, DSNURWUT, DSNUCBRK 


ee End of Internal DB2 information ere? 


System Action: The utility job is abended. An SDUMP of the 
ADMF address space will be requested. 


User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix -B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40336 — 00E40404 


00E40401 


Explanation: An error has been detected while scanning for a 
specified key in REPAIR by KEY processing. 


[ ~——_- Internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNUCBRP 


ee End of internal DB2 Information eres | 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40403 


Explanation: An error has been detected while scanning for 
the requested RECORD during REPAIR by record processing. 


[- Internal DB2 information i a 


This abend reason code is issued by the following CSECT(s): 
DSNUCBRP 


| End of internal DB2 Information 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40404 


Explanation: An error has been returned from the get-page 
function, DSNBGETP. 


i. ~~ _ Internal DB2 Information ~~ = | 


This abend reason code is issued by the following CSECT(s): 
DSNUCBRP 


a End of Internal DB2 Information eer ee 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


DB2 Codes 4-195 


00E40405 — 00E40413 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40405 


Explanation: An error has been returned from the open-piece 
function, DSNBOPPP. 


[ ~~ Internal DB2 Information ~ 


This abend reason code is issued by the following CSECT(s): 
DSNUCBRP 


es End of Internal DB2 Information _ 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E 40406 


Explanation: An error has been returned from the replace- 
page function, DSNBRELP. 


f= Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUCBRP 


Ue ee End of internal DB2 Information _ 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40410 


Explanation: An error has been returned from a DSNISETR 
protocol during REPAIR DELETE processing. 


a Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUCDEL 


Mee End of Internal DB2 Information ee 


System Action: Utilities processing is abended. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


4-196 DB2 Messages and Codes 


00E40411 


Explanation: An error has been returned from a DSNIDLET 
protocol during REPAIR DELETE processing. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUCDEL 


Piz eae: End of Internal DB2 Information i 


System Action: Utilities processing is abended. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


00E40412 


Explanation: An error has been detected by the REPAIR utility 
during LOCATE KEY processing. Specifically, the DSNISRCF 
protocol has returned an error. 


| Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNUCBRK 


| s End of Internal DB2 Information _____——_| 


System Action: The utility job step is placed in the stopped 
state. 


Problem Determination: This abend code may be accompanied 
by a DSNT500 error message that may indicate a correctable 
problem. If the DSNT500 message has not been issued or if the 
problem can not be corrected, collect the following diagnostic 
items listed in Appendix B, “Problem Determination” on 

page X-5: 1, 59, 60, 5, 31, 45. 


00E40413 


Explanation: An error has been detected by the REPAIR utility. 
Specifically, the DSNINOTC protocol has returned an error. 


: internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUCBRP, DSNUCBRR, DSNUCDEL 


tee ee End of Internal DB2 Information Sete | 


System Action: The utility job step is placed in the stopped 
state. 


Problem Determination: This abend code may be accompanied 
by a DSNT500 error message that may indicate a correctable 
problem. If the DSNT500 message has not been issued or if the 
problem can not be corrected, collect the following diagnostic 
items listed in Appendix B, “Problem Determination” on 

page X-5: 1, 59, 60, 5, 31, 45. 


00E40500 


Expianation: An error has been returned by the reset function, 
DSNPRSPS or DSNPREST. 


I. Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUGTER 


ee End of Internal DB2 Information poset eet 


System Action: Utilities processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment. Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: This abend may be accompanied by 
one or more DSN messages to the operator’s console. The 
DSN messages may indicate a user error that can be corrected. 
If DSN messages do not accompany this message, the likely 
cause of the abend is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 59, 60, 5, 31, 45. 


00E40600 


Explanation: There was a RESTCAT utility abend on the batch 
side of DB2. The utility terminates and ali work up to the time of 
abend is backed out. 


= ” 7 Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 


DSNUECML DSNUECMU DSNUECM1 
DSNUEO!D DSNUEXLO DSNUEXUN 


 eeeeecreee End of Internal DB2 Information Gee 


System Action: The execution unit driving this function pro- 
ceeds normally. A user dump is requested. 


Operator Response: Notify the system programmer, request 
the user dump, and print the SYS1.LOGREC, the BSDS, and the 
unload catalog data set. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for symptom determination, failure 
analysis procedures, and for information about dump analysis 
and service aids. 


Problem Determination: SYSOUT may contain the record being 
processed at the time of abnormal termination. 


The following general purpose registers (GPRs) contain the 
indicated diagnostic information: 


GPR Content 
2 Address of the error message 
5 Address of the load table 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 60, 5. 


00E40500 — 00E40702 


00E40601 


Explanation: There was a RESTCAT utility abend on the ADMF 
side of DB2. The utility terminates and all work up to the time of 
abend is backed out. 


Internal DB2 Information : 


This abend reason code is issued by the following CSECT(s): 
DSNUECMI 


et et End of Internal DB2 Information ee 


System Action: The execution unit driving this function pro- 
ceeds normally. 


Operator Response: Notify the system programmer, request 
the SVC dump, and print the SYS1.LOGREC, the BSDS, and the 
unload catalog data set. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for symptom determination, failure 
analysis procedures, and for information about dump analysis 
and service aids. 


Problem Determination: The following general purpose regis- 
ters (GPRs) contain the indicated diagnostic information: 


GPR Content 
2 Address of the error message 
7 Address of CT 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


00E40609 


Explanation: A DBD was encountered which is discontiguous 
in the EDM Pool due to prior DDL operations and the DBD is 
currently accessed by users. The utility requires the DBD to be 
contiguous in the EDM Pool. 


[ ~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUECMI 


ere see End of Internal DB2 information mae, 


System Action: The utility that detected this condition returns 
“RESOURCE NOT AVAILABLE” to its invoker. 


User Response: Allow all DDL and DML on this database to 
cease; this will allow the DBD to be flushed from the EDM Pool. 
After all.users have finished accessing the database, invoke the 
utility again. A contiguous DBD will be brought into the EDM 
Pool. 


00E40702 


Explanation: An error has been detected by CHECK DATA 
utility during table scanning processing. The data manager pro- 
tocol DSNISRCF has returned an error. 


DB2 Codes 4-197 


00E40703 — 00E40707 


| Interna] DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUKSCT 


Bee Meas End of Internal DB2 Information a) 


System Action: Utility processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E40703 


Explanation: An error has been detected -by CHECK DATA 
utility during table scanning processing. The data manager pro- 
tocol DSNINXTR has returned an error. 


[— oe 4. Internal DB2 Information | 


This abend code is issued by the following CSECT(S): 
DSNUKSCT 


Chee End of Internal DB2 Information pean esto al 


System Action: Utility processing is abended. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E40704 


Explanation: The CHECK DATA utility detected an error during 
table scanning processing or delete processing. The data 
manager protocol DSNISETR returned an error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUKSCT, DSNUKRDN.DSNUKRDY 


dese —ar Wee: End of internal DB2 Information ree | 


System Action: Utility processing abends. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 


for symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


4-198 DB2 Messages and Codes 


00E40705 


Explanation: The CHECK utility detected an error during the 
keys (index key or foreign keys) extraction process. The data 
manager protocol DSNIEXTK returned an error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUKSCT, DSNUKICK 


We se eee End of Internal DB2 Information _ sd 


System Action: Utility processing abends. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 


for symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E40706 


Explanation: The CHECK DATA utility detected an error while 
processing primary keys matching. The data manager protocol 
DSNKSET returned an error. 


| ~—_ Internal DB2 Information 2 os 


This abend reason code is issued by the following CSECT(s): 
DSNUKIFK, DSNUKNFK 


eee eee ene End of Internal DB2 Information | 


System Action: Utility processing abnormally terminates. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 


for symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E40707 


Explanation: The CHECK DATA utility detected an error while 
processing primary keys matching. The data manager protocol 
DSNKNEX returned an error. 


a aoe Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUKIFK 


reteaeiatas End of Internal DB2 Information Ager getest eh. 


System Action: Utility processing abnormally terminates. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 
for symptom determination and failure analysis procedures. 


| 
| 
| 
| 
| 
| 


| 
| 
| 
| 
| 
| 
| 
| 


| 
| 
| 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E40708 


Explanation: The CHECK DATA utility detected an error while 
positioning records for cascade delete processing. The data 
manager protocol DSNISETD returned an error. 


| internal DB2 Information a 


This abend reason code is issued by the following CSECT(s): 
DSNUKRDY 


aera doe End of Internal DB2 Information eee et 


System Action: Utility processing abnormally terminates. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 


for symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E40709 


Explanation: An error has been detected by the CHECK DATA 
utility during positioning of records for cascade delete proc- 
essing. The data manager protocol DSNINEXD has returned an 
error. 


TT “—————~_ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNUKRDY 


ae oe End of Internal DB2 Information pieet = | 


System Action: Utilities processing is abnormally terminated. 


User Response: Correct the error condition identified by the 
DSNT500!I message, terminate the utility and restart it from the 
beginning. 

Operator Response: Notify the system programmer. 

System Programmer Response: if the condition identified 
cannot be corrected, determine the failing environment and 


refer to Section 5 of Diagnosis Guide and Reference for 


symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E4070A 


Explanation: The CHECK DATA utility detected an error during 
inserting records processing.The data manager protocol 
DSNISRT returned an error. 


00E40708 — 00E40900 


| Eee Internal DB2 Information speek | 


This abend reason code is issued by the following CSECT(s): 
DSNUKRDN, DSNUKRDY 


ee End of Internal DB2 information | 


System Action: Utility processing abnormally terminates. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 


for the symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E4070B 


Explanation: The CHECK DATA utility detected an error during 
cascade delete processing. The data manager protocol 
DSNIDLET returned an error. 


| Internal DB2 Information ==: 


This abend reason code is issued by the following CSECT(S): 
DSNUKRDY 


{ End of internal DB2 Information ee ees 


System Action: Utility processing abnormally terminates. 
User Response: Notify the system programmer. 


System Programmer Response: Determine the failing environ- 
ment and refer to Section 5 of Diagnosis Guide and Reference 


for symptom determination and failure analysis procedures. 
Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E40900 


Explanation: The DIAGNOSE utility forced an ABEND. The 
specified instance of the specified utility TRACEID or message, 
from the DIAGNOSE ABEND utility input statement, was 
encountered during utility processing while DIAGNOSE mode 
was on. 


= S.. Internal DB2 Information ~~ : i: | 


This abend reason code is issued by the following CSECT(s): 
DSNUGABN 


eee End of Internal DB2 Information arta 


System Action: The utility is ABENDed as requested. 


User Response: Continue with the diagnosis procedure in 
progress. 


Refer to Section 5 of Diagnosis Guide and Reference for 
symptom determination and failure analysis procedures. 


Problem Determination: The ABEND option of the DIAGNOSE 
utility was invoked to force an abend on a particular instance of 
a specified utility TRACEID or message. The instance of that 


DB2 Codes 4-199 


00E40901 — 00E40901 


TRACEID or message was encountered during utility proc- 
essing while DIAGNOSE mode was active and an abend was 
forced to occur at that point. 


00E 40901 


Explanation: The DIAGNOSE utility failed while attempting to 
set the batch utility address space non-swappable. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNUDIAG 


[Ls End of internal DB2 Information _______| 


4-200 DB2 Messages and Codes 


System Action: Utility processing is abended. 


User Response: Terminate the utility and restart it from the 
beginning. If the problem persists, wait until fewer applications 
are running on the system before resubmitting the job. 


System Programmer Response: Determine the environment 
for the SYSEVENT TRANSWAP failure. Refer to Section 5 of 
Diagnosis Guide and Reference for symptom determination and 
failure analysis procedures. 


Problem Determination: The DIAGNOSE utility attempted to set 
the batch utility address space non-swappable by issuing a 
SYSEVENT TRANSWAP operation. The operation failed to set 
the address space non-swappable. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 60, 5, 31. 


00E50001 — 00E50013 





Agent Services Manager Codes (X'E5') 


00E50001 


Explanation: A latch acquisition request violates latch dead- 
lock prevention protocols. {f the request was unconditional, the 
execution unit owns a latch at a level equal to or greater than 
the level of the requested latch. If the request was conditional, 
the execution unit already owns a Jatch at the requested level. 
This is a DB2 subsystem error. 


=a internal DB2 Information ~————— “il 


This abend reason code is issued by the following CSECT(s): 
See 'Problem Determination’. 


ees eee End of Internal DB2 Information Pt ead 


System Action: The requesting execution unit is abended. 


System Programmer Response: Collect the necessary diag- 
nostic material. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures and for information 
about dump analysis and service aids. 


Operator Response: Notify the system programmer of the 
abend. 


Problem Determination: This abend is issued by the in-line 
expansions of the latch acquisition macros DSNVLTHS and 
DSNVLTHX. 


At the time of the abend, diagnostic information has been 
placed in general registers 2 through 5. 


Register Contents 

2 Latch class number (1-32). 

3 Address of the latch. 

4,5 Latch class name (1 to 8 characters, left- 
justified). 


Registers 2-12 of the invoking module were saved in the save 
area pointed to by register 13 at the time the error was 
detected. 


It is the responsibility of the requesting resource manager to 
have functional recovery in place before requesting a latch. It is 
expected that a record will be written to SYS1.LOGREC and a 
DB2 SVC dump will be requested. Examine SYS1.LOGREC and, 
if available, the SVC dump to determine the subcomponent and 
module requesting the latch. , 


00E50002 


Explanation: A release latch request was issued for a latch 
not held by the requesting execution unit. This is a DB2 sub- 
system error. 


Internal DB2 Information ~ — a | 


This abend reason code is issued by the following CSECT(s): 
See 'Problem Determination’. 


a ae End of Internal DB2 information eae Seed 


System Action: The requesting execution unit is abended. 


System Programmer Response: Collect the necessary diag- 
nostic material. Refer to Section 5 of Diagnosis Guide and Ref- 
erence for failure analysis procedures and for information 
about dump analysis and service aids. 


Operator Response: Notify the system programmer of the 
abend. 


Problem Determination: This abend is issued from within the 
in-line expansions of the latch release macros DSNVUNLS and 
DSNVUNLX. 


At the time of the abend, diagnostic information has been 
placed in general registers 2 through 5. 


Register Contents 

2 Latch class number (1-32). 

3 Address of the latch. 

4,5 Latch class name (1-8 characters, left justified). 


Registers 2-12 of the invoking module were saved in the save 
area pointed to by register 13 at the time the error was 
detected. 


It is the responsibility of the requesting resource manager to 
have functional recovery in place while holding a latch. A 
record will be written to SYS1.LOGREC, and a DB2 SVC dump 
will be requested. Examine SYS1.LOGREC and, if available, the 
SVC dump to determine the subcomponent and module 
requesting the latch. 


00E50004 


Explanation: An error was found while attempting to resume a 
waiter after a latch was released. This abend is issued when 
the next resource options block (ROB) to be resumed is the 
same as the immediately previous ROB. That is, the ROBCHNA 
of a ROB points to itself. 


: internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNVXULO 


Mee tees End of internal DB2 Information ee td 


System Action: The current execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Collect the necessary diag- 
nostic materials. Refer to Section 5 of Diagnosis Guide and 
Reference for failure analysis procedures and for information 
about dump analysis and service aids. 


Problem Determination: A record is written to SYS1.LOGREC, 
and a DB2 SVC dump is requested. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50013 


Explanation: A DB2 execution unit has been abended. This 
abend code must ultimately be issued by resource managers 
when the CANCEL exit is driven as a result of a suspend 
request. 


DB2 Codes 4-201 


00E50014 — 00E50030 


== =e ~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 


DSNVEUS1 DSNVEUS3 DSNVASTM 
DSNVCSTO DSNVDSTO DSNVFEB 
DSNVSLTO DSNVSULO DSNVXLTO 


pees ee End of Internal DB2 Information ee eee 


System Action: The agent cancel processing continues. 


Operator Response: Notify the system programmer only if the 
abend results in the termination of the DB2 subsystem. 


System Programmer Response: This reason code may be 
issued as a result of any connected TCB abend, or operator 
-STOP DB2 MODE(FORCE) command. No further action is 
required. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA. 


Problem Determination: If DB2 abends, examine the SVC dump 
to determine the suspended resource manager and the state of 
the failing subcomponent. For example, the ACEMC (must com- 
plete) bit should be off. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50014 


Explanation: Either the execution block (EB) or the agent ser- 
vices global communication area (VGCA) was invalid. The 
error was detected when the agent services resume function 
attempted to resume a TCB in an address space other than the 
primary of the resume requester. This is a subsystem error. 


ae Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNVRSRB 


[ele ee 8 End of Internal DB2 Information Stiefel 


System Action: The error is percolated (passed) to the 
recovery routine for the TCB that was to have been resumed. 


Operator Response: Notify the system programmer. 


System Programmer Response: The recovery routine for the 
CSECT issuing this reason code records information in the vari- 
able recording area (VRA). Refer to Section 5 of Diagnosis 
Guide and Reference for more information about the VRA and 
for failure analysis procedures. 


Problem Determination: An entry is written to SYS1.LOGREC, 
and a DB2 dump is requested by the FRR DSNVSRR. Examine 
the SVC dump and determine the resource manager module 
requesting the resume operation. Register 3 contains the SRB 
address. Register 5 contains the EB address. If the VGCA is 
invalid, its address is in register 8. The EB in question is that of 
the target TCB. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


4-202 DB2 Messages and Codes 


00ES0015 


Explanation: The MVS contro! block (either RB or STSV - SRB 
Status Save Area) that was the intended object of a resume 
request was invalid. The RB or STSV address was obtained 
from the DB2 EB (execution block) at offset X'1C'. This isa 
subsystem error. 


[ Internal DB2 Information ia ais 


This abend reason code is issued by the following CSECT(s): 
DSNVSR, DSNVRSRB 


re End of Internal DB2 Information eR el 


System Action: If the CSECT that abends is DSNVRSRB, the 
error is percolated (passed) to the recovery routine for the TCB 
that was to have been resumed. If the CSECT that abends is 
DSNVSR, the error is percolated to the DB2 SRB recovery task 
DSNVRCT. Ultimately, the subsystem may be terminated abnor- 
mally. 


Operator Response: Notify the system programmer. 


System Programmer Response: The recovery routine for the 
CSECT issuing this reason code records information in the vari- 
able recording area (VRA). Refer to Section 5 of Diagnosis 
Guide and Reference for more information about the VRA and 
for failure analysis procedures. 


Problem Determination: A SYS1.LOGREC entry and a DB2 SVC 
dump are requested by the FRR DSNVSRR. Register 6 contains 
the target EB address. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50029 


Explanation: The Agent Services function which establishes 
the DB2 tasking structure abends with this reason code fol- 
lowing the detection of a load module which was loaded without 
the 31-bit addressing capability. The abend is preceded by 
message DSNV0239. 


| ——— _ {Internal DB2 Information ~~ Se 


This abend reason code is issued by the following CSECT(s): 
DSNVASIM 


es eee End of internal DB2 Information eee 


System Action: Subsystem start-up is terminated. 
System Programmer Response: See message DSNV029I. 
Operator Response: See message DSNV029I. 


Problem Determination: See message DSNV029I. 


00E50030 


Explanation: A request was made to initialize an already- 
initialized DB2 address space. This is a subsystem error. 


| Internal DB2 Information ~—————S = =I 


This abend reason code is issued by the following CSECT(s): 
DSNVASIM 


——— a End of Internal DB2 Information eee, 


System Action: The requesting execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Examine the SVC dump and 
determine the resource manager module (contents of register 
14 in save area pointed to by register 13) that invoked 
DSNVASIM. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for failure analysis procedures. 


Problem Determination: A record is written to SYS1.LOGREC, 
and an SVC dump is requested. Register 6 contains the 
address of the EB. Field EBPASCE contains the ASCE address 
of the address space to be initialized. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50031 


Explanation: An agent termination request was issued from a 
secondary execution unit for an agent created with APLOPT = 1. 
This is an invalid use of the terminate allied agent function. 


= ~~~ Internal DB2 Information : 


This abend reason code is issued by the following CSECT(s): 
DSNVTRTH 


ee End of Internal DB2 Information cgi yl 


System Action: The requesting execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the resource 
manager module that invoked DSNVTRTH. Register 14, in the 
save area pointed to by register 13, contains the return address 
of the invoking module. Refer to Section 5 of Diagnosis Guide 
and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA. 


Problem Determination: A record is written to SYS1.LOGREC, 
and a DB2 SVC dump is requested. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50032 


Explanation: An agent services manager functional request 
was issued with an invalid specification of the ACE operand. 
This is an invalid use of the requested service. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNVTRTH, DSNVDISC, DSNVCONN 


Lo End of Interna! DB2 Information eer ee | 


00E50031 — 00E50036 


System Action: The requesting execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Verify that the ACE control 
block is a valid allied agent. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA. 


Problem Determination: A record is written to SYS1.LOGREC, 
and an SVC dump is requested. Register 1 at entry to the 
module normally contains the ACE address. However, if reg- 
ister 1 at entry to DSNVTRTH is zero, then the address at reg- 
ister 6 is the ACE address to be terminated. That address 
points to the EBROB which, in turn, points to the ROBACE. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50035 


Explanation: During the processing of a request to perform 
system agent allocation, a resource manager returned a 
nonzero return code from an allocation notification. This is a 
subsystem error. 


| Internal DB2 Information ~ Sa a 


This abend reason code is issued by the following CSECT(s): 
DSNVIALC 


a End of Internal DB2 Information eet | 


System Action: The requesting execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: The error is recorded on 
SYS1.LOGREC, and an SVC dump is requested. Register 7 con- 
tains the nonzero allocation return code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00ES0036 


Explanation: A request was made to perform system agent 
allocation for an agent that had already been allocated. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNVIALC 


Beg tes aes End of Internal DB2 Information Gases || 


System Action: The requesting execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: The error is recorded on 
SYS1.LOGREC, and an SVC dump is requested. The fullword 
address at register 6, which points to the EBROB, should have 


DB2 Codes 4-203 


00E50040 — 00E50045 


been zero. That address points to the ROBACE which, in turn, 
points to the ACERAL. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50040 


Explanation: DB2 subsystem termination was invoked fol- 
lowing an unrecoverable error while processing a terminate 
allied agent request at the thread, sign on, or identify level. 
The FRR (DSNVTFRR) covering module DSNVTRTH was unable 
to recover. This is a subsystem termination reason code. 


‘a a a: Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNVTFRR 


L End of internal DB2 Information gee atl 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Scan the MVS system log and the con- 
tents of SYS1.LOGREC for DB2 abends occurring immediately 
before the system termination message DSNVO86E. Follow the 
failure analysis procedures for the specific abend(s). Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E’ abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50041 


Explanation: DB2 subsystem termination was invoked fol- 
lowing an unrecoverable error while processing a terminate 
agent structure request. The FRR (DSNVTFRR) covering 
module DSNVFACE was unable to recover. This is a subsystem 
termination reason code. 


[ —-—sSWTnternal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNVTFRR 


Be oa Ste End of Internal DB2 Information ee 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Scan the MVS system log and the con- 
tents of SYS1.L.OGREC for DB2 abends occurring immediately 
before the system termination message DSNVO86E. Follow the 
failure analysis procedures for the specific abend(s). Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


4-204 DB2 Messages and Codes 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50044 


Explanation: A terminate agent request was issued for an 
agent with an active unit of recovery (URE). This is an invalid 
use of the terminate allied agent service and is a subsystem 
error. 


— ~_ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNVTRTH 


ee End of Internal DB2 Information oe Secs 


System Action: The requesting execution unit is abnormally 
terminated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA. 


Problem Determination: The error is recorded on 
SYS1.LOGREC, and an SVC dump is requested. Register 1 at 
entry to the module contains the ACE address of the agent to be 
terminated. The ACEURE field should have been zero. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50045 


Explanation: DB2 subsystem termination was invoked fol- 
lowing an unrecoverable error while processing a create allied 
agent service request at the thread, sign on, or identify level. 
The FRR (DSNVCFRR) covering module DSNVCRTH was unable 
to recover. This is a subsystem termination reason code. 


a — Internal DB2 Information ~— | 


This reason code is issued by the following CSECT(s): 
DSNVCFRR 


a End of Internal DB2 Information eee 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Scan the MVS system log and the con- 
tents of SYS1.LOGREC for DB2 abends occurring immediately 
before the system termination message DSNVO86E. Follow the 
failure analysis procedures for the specific abend(s). Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00ES0046 


Explanation: DB2 subsystem termination was invoked fol- 
lowing an unrecoverable error while processing a create agent 
structure request. The FRR (DSNVCFRR) covering module 
DSNVGACE was unable to recover. This is a subsystem termi- 
nation reason code. 


| Internal DB2 Information ~~ ey 


This reason code is issued by the following CSECT(s): 
DSNVCFRR 


[End of internal DB2 Information 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Scan the MVS system log and the con- 
tents of SYS1.LOGREC for DB2 abends occurring immediately 
before the system termination message DSNVO8G6E. Follow the 
failure analysis procedures for the specific abend(s). Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50047 


Explanation: DB2 subsystem termination was invoked fol- 
lowing an unrecoverable error while processing a Format EB 
RMROQ request. The FRR (DSNVCFRR) covering module 
DSNVFEB was unable to recover. This is a subsystem termi- 
nation reason code. 


i —— {Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNVCFRR 


| End of Internal DB2 Information 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about the SDWA, dump analysis, and service 
aids. 


Problem Determination: Scan the MVS system log and the con- 
tents of SYS1.LOGREC for DB2 abends occurring immediately 
before the system termination message DSNVO8G6E. Follow the 
failure analysis procedures for the specific abend(s). Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50046 — 00E50051 


00E50050 


Explanation: The MVS cross-memory lock (CML) of the system 
services address space was held by the invoking resource 
manager execution unit during invocation of the cancel, 
suspend, or resume functions. This violates the entry protocols 
for these functions. 


| — Internal DB2 tnformation io eae 


This abend reason code is issued by the following CSECT(s): 
DSNVSR 


{ Ss End of internal DB2 Information 


System Action: The requesting execution unit is abnormally 
terminated. 


Because resource manager serialization cannot be maintained 
without the use of this lock, normal recovery is not possible for 
this abend. The recovery routine terminates the DB2 sub- 
system through invocation of the agent services subsystem ter- 
mination protocol. 


An '00E50054' recovery reason code is placed in the 
SDWACOMU field of the SDWA, indicating that synchronization 
services was responsible for DB2 subsystem termination. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for faiture analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: Internal protocols specify that no MVS 
locks may be held at DSNVSR invocation. Determine the 
invoking resource manager, the function requested, and the 
current owner (ASCB) of the CML lock at the time of the error. 
Diagnostic information for this error may be obtained through 
the SYS1.LOGREC and DB2 SVC dump materials provided. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00ES50051 


Explanation: The resource manager requesting the resume 
function specified the TCTL = YES option while executing in TCB 
mode. This violates the entry protocols for this function. This is 
a subsystem error. 


| Internal DB2 Information = “| 


This abend reason code is issued by the following CSECT(s): 
DSNVSR 


Lo End of Internal DB2 Information foe 2 = oe 


System Action: Mainline processing is abnormally terminated 
with an '04E' abend code and this reason code. 


Because this error is an internal resource manager protocol 
violation, normal recovery is not possible for this abend. The 
recovery routine terminates the DB2 subsystem through invoca- 
tion of the agent services subsystem termination protocol. An 
'00E50054' recovery reason code is placed in the SDWACOMU 


DB2 Codes 4-205 


00E50052 — 00E50055 


field of the SDWA indicating that synchronization services was 
responsible for DB2 subsystem termination. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: Internal protocol documentation spec- 
ifies that the TCTL = YES option is valid only for resource man- 
agers executing in SRB mode at time of invocation. Determine 
the invoking resource manager at time of error. Diagnostic 
information for this error may be obtained through the 
SYS1.LOGREC and DB2 SVC dump materials provided. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50052 


Explanation: The MVS cross-memory lock (CML) of the system 
services address space could not be released during termi- 
nation processing of the cancel, suspend, or resume functions. 


; — Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNVSR 


enn End of Interna! DB2 Information oer te 


System Action: Mainline processing is abnormally terminated 
with an '04E' abend code and this reason code. 


Because resource manager Serialization can no longer be 
maintained. without the use of this lock, normal recovery is not 
possible for this abend. The recovery routine terminates the 
DB2 subsystem through invocation of the agent services sub- 
system termination function. 


An '00E50054' recovery reason code is placed in the 
SDWACOMU field of the SDWA indicating that synchronization 
services was responsible for DB2 subsystem termination. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: For this abend to occur, the CML lock 
must have been successfully obtained at some point during 
mainline processing. Determine the invoking resource 
manager, the function requested, and the current owner (ASCB) 
of the CML lock at the time of the error. Diagnostic information 
for this error may be obtained through the SYS1.LOGREC and 
DB2 SVC dump materials provided. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 7. 


4-206 DB2 Messages and Codes 


00E50054 


Explanation: The DB2 subsystem is abended by the synchroni- 
zation services recovery routine when an unrecoverable error 
is encountered during recovery processing for the suspend, 
cancel, or resume functions. This is a subsystem termination 
reason code. 


[ Internal DB2 Information : 


This reason code is issued by the following CSECT(s): 
DSNVSRR 


ae End of Internal DB2 Information a ees 


System Action: The DB2 subsystem is terminated. This reason 
code is associated with an '04F' abend code indicating that 
synchronization services was responsible for termination. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Scan the MVS system log and the con- 
tents of SYS1.LOGREC for DB2 abends occurring immediately 
before the system termination message DSNVO86E. Follow the 
failure analysis procedures for the specific abend(s). Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


One of the following conditions was encountered during 
recovery processing for the requested function: 


¢ Unable to complete resume processing for an SRB mode 
execution unit that was suspended at time of error. 

¢ Errors were encountered during primary recovery proc- 
essing causing entry to the secondary recovery routine. 

* Recovery initiated retry to mainline Suspend/Resume code 
caused retry recursion entry into the functional recovery 
routine. 

¢ Unable to obtain or release the cross-memory lock (CML) of 
the system services address space either during mainline 
processing or during functional recovery processing (for 
example, reason code '00E50051' or '00E50052'). 

¢ The invoking resource manager requested the TCTL= YES 
option of the resume function while executing in TCB mode 
(for example, reason code '00E50051'). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50055 


Explanation: The synchronization services functional recovery 
routine was unable to successfully complete resume proc- 
essing for a suspended TCB mode execution unit. The resume 
processing was requested by the cancel or resume functions. 
This reason code is placed in the SDWACOMU field of an 
SDWA. 


cov ~~ _ Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNVSRR 


Di ae ee End of Internal DB2 Information Pees 


System Action: Because the suspended TCB mode execution 
unit must not be permitted to remain in a suspended state, the 
recovery routine invokes the MVS CALLRTM (TYPE=ABTERM) 
service to abend the execution unit with an '04F' completion 
code. Depending upon which execution unit was terminated, 
the DB2 subsystem may be abended. 


Operator Response: Notify the system programmer, and 
restart DB2 if necessary. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Scan the MVS system log and the con- 
tents of SYS1.LOGREC for DB2 abends occurring immediately 
before the abend of the execution unit. Follow the failure anal- 
ysis procedures for the specific abend(s). Refer to “DB2 Abend 
Completion Codes (X'04E' and X'04F)” on page 1-6 for infor- 
mation about X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 7. 


00E50059 


Explanation: When preparing to resume an SRB, the target EB 
(execution block) was validated by checking the EB identifier 
code in the first halfword of the control block. The identifier 
code was in error. 


| ~~ Internal DB2 Information Pa ge 1 


This abend reason code is issued by the following CSECT(s): 
DSNVSR 


——— End of Internal DB2 Information eee) 


System Action: The error is percolated (passed) to the DB2 
SRB recovery task DSNVRCT. Ultimately, DB2 is terminated 
abnormally. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA. 


Problem Determination: A LOGREC entry and a DB2 dump are 
requested by the FRR DSNVSRR. Register 6 contains the 
address of the invalid EB. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00ES0062 


Explanation: An application request (RARQ) was issued to a 
resource access list (RAL). At the time of the request, the RAL 
had the RAL suppress (RALSUPPR) flag on, and the function 
vector list entry (FVLE) that was accessed (through FRBFVLE) 
did not have FVLEBITO on. This is not allowed. That is, the 
FVLE function is not allowed during RAL suppress. 


This error may indicate that an IMS/VS or CICS caller had com- 
pleted Commit Phase 1 and that the next request was not 

Commit Phase 2, Abort, or Terminate with the Commit or Abort 
option. This abend is the result of an internal system problem, 


00E50059 — 00E50063 


possibly the DB2 attachment facility or the requesting IMS/VS or 
CICS subsystem. 


| : Internal DB2 Information a 


This abend reason code is issued by the following macro(s): 
DSNARARQ 


| snd of Internal DB2 Information 


System Action: The allied task requesting the RARQ is, 
abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The recovery routines of the module 
invoking the DSNARARQ macro should have requested 
SYS1.LOGREC recording and either an SVC or application 
dump (or both.) Register 1 points to the FRB. The FRB contains 
the FRBRALE and FRBFVLE entries. It also contains the 
pointers to the RAL and to the execution block address 
(FRBEB). Register 3 contains the address of the RAL from 
FRBRAL. Register 4 contains the address of the RALE as 
located by the FRBRAL pointer (and as indexed by FRBRALE). 
Register 6 contains the address of the EB from FRBEB. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 21, 22, 23, 24, 25. 


00E50063 


Explanation: A resource access request (RARQ) was issued to 
a function vector list entry (FVLE) that is valid but unauthorized 
for this allied user at this time. This abend occurs if a request 
is issued out of sequence. For example, two consecutive 
CREATE THREAD requests would give this result. This abend 
also occurs if a request is issued that is never authorized for 
the caller. For example, it occurs if a BATCH protocol user 
issues a PREPARE request. A program call (PC) is issued to 
module DSN3ABND, which issues the X'04E' abend with this 
reason code. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SABND 


att a ee End of internal DB2 Information ee 


System Action: The task issuing the RARQ is abended. 
However, DB2 recovery may translate this abend to a return 
code 256 with this reason code. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: This is a user error. The issuer of the 
RARQ was not authorized to use the requested function at this 
time. The following diagnostic information is available: 


¢ An entry in the DB2 trace table is made for entry to module 
DSNS3ABND. The items traced are the RALE and the FVLE 
of the intended DSNARARQ request. To determine the 


DB2 Codes 4-207 


00E50065 — 00E50071 


sequence of DSNARARQ requests, examine the previous 
trace table entries for.the same execution block (EB). 

e An application dump is requested with DB2-supplied control 
blocks. This includes the FRB associated with the intended 
DSNARARQ request. Fields FRBRALE and FRBFVLE con- 
tains the indexes for the intended request. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 4, 5. 


00E50065 


Explanation: RMRQ linkage was requested, specifying a func- 
tion code that is undefined in the resource manager function 
table (RMFT) of the designated resource manager. 


| —— ~ Internal DB2 information SS 


This abend reason code is issued by the following CSECT(s): 
DSNVRMEL 


Ree oe End of Internal DB2 Information eee 


System Action: The execution unit under which RMRQ was 
requested is abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: The recovery routine of the abended 
resource manager module requested SYS1.LOGREC recording 
and a DB2 SVC dump. Register 14 points to the resource 
manager module that requested linkage to the undefined func- 
tion. 


Collect the foliowing diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50069 


Explanation: This abend code is issued during recovery proc- 
essing for the suspend function when executing in SRB mode 
under the recovery routine established by the MVS 
SRBSTAT(SAVE) service. Because the recovery routine estab- 
lished by this service is the only routine in the FRR stack at the 
time of error, normal RTM percolation to the invoking resource 
manager recovery routine is not possible. 


After recovery processing for the initial mainline error has suc- 
cessfully completed, the RTM environment is exited through 
retry to a routine that restores the original FRR stack. This 
routine then issues an '04E' abend with this reason code. This 
causes entry into the original recovery routine established 
during suspend initialization. 


i = : Internal DB2 Information : 7 7 7 


This abend reason code is issued by the following CSECT(s): 
DSNVSRR 


tos Sees End of Internal DB2 Information eee 


System Action: After this abend is intercepted by the original 
suspend recovery routine, a SYS1.LOGREC entry and DB2 SVC 
dump are requested to document the original error. The ori- 
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ginal recovery reason code is placed in the SDOWACOMU field of 
the SDWA indicating the actions performed during recovery 
processing of the initial error. Control is then returned to the 
invoking resource manager’s recovery routine through RTM 
percolation. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Because this abend is used only to 
permit the transfer of the initial recovery reason code to the 
invoking resource manager’s recovery routine, no further 
recovery actions are required for this abend. Diagnostic infor- 
mation for the initial error encountered during mainline proc- 
essing may be obtained through the SYS1.LOGREC and SVC 
dump materials provided. 


00E50070 


Explanation: This abend reason code is issued in response to 
a delete service task request specifying purge. Additionally, 
any service task not deleted by the owning resource manager 
at subsystem shutdown is abended with this reason code. 


‘. ~~ _ Internal DB2 Information os 5 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS3, DSNVDSTO, DSNVEOT1 


| End of internal DB2 Information 


System Action: This abend usually occurs through MVS 
CALLRTM and, in certain cases, is issued by the service task 
dispatcher executing under the TCB being abended. The 
service task is abended. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refe. 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: If the service task is abended with a 
completion code of X'04F', no DB2 SVC dump is taken. Some 
resource managers have elected to terminate their service 
tasks with the purge option. Consequently, the abend may or 
may not be an actual error. At the time of the abend, register 6 
points to the execution block (EB) of the execution unit that was 
active when the abend occurred. The EBSQH field in turn con- 
tains a pointer to the service queue header associated with the 
abending service task. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50071 


Explanation: This abend reason code is issued following a 
cancel return from the resume service during an attempt to 
notify the create service task requester. Because the requester 
has been terminated, the newly created service task must be 
terminated. 


_—— - — Internal DB2 Information ee 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS3 


et Steere End of Internal DB2 Information bos Sal nll 


System Action: The service task is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variabie recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: At the time of the abend, register 6 
points to the execution block (EB) assigned to the service task 
dispatcher. The EBSQH field, in turn, contains a pointer to the 
service queue header associated with the abending service 
task. From the SQH, determine the requesting resource 
manager. Prior SYS1.LOGREC entries may indicate why the 
requester was terminated. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50072 


Explanation: This abend reason code is issued following an 
unanticipated cancel return from DSNVSR for an execution unit 
not expected to be canceled. This code is aiso a subsystem ter- 
mination reason code if the abend was issued by module 
DSNVCSTO. 


— ~~ Internal DB2 Information Se es all 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS3, DSNVEUS4, DSNVCST0, DSNVEOT1 


US aoe ee End of Internal DB2 Information ———— 


System Action: The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: At the time of the abend, register 6 
points to the execution block (EB) associated with the abending 
execution unit. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50074 


Explanation: This abend reason code is issued in response to 
a nonzero return code from ATTACH during an attempt to 
create a service task. 


00E50072 — 00E50076 


| — Internal DB2 Information ~~ gl 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS4 


ee eeerer End of Internal DB2 Information et rae 


System Action: The ATTACH is retried. If a failure occurs 
again, DB2 is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2 if necessary. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Register 2, in the SDWA, contains the 
return code from the ATTACH request. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50075 


Explanation: On an execution unit switch request, an invalid 
service queue header (SQH) and/or service task identifier 
(STID) was specified. Alternately, the specified or implicit 
address space may be invalid. This is an internal DB2 protocol 
error. 


[ " Internal DB2 Information ~~ So ari 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS1 


ae eee End of internal DB2 Information | 


System Action: The requester is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Using the SYS1.LOGREC entry and the 
associated SVC dump, determine the resource manager 
module that requested the execution unit switch. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50076 


Expianation: A request was made for an execution unit switch 
to a service task currently undergoing delete processing. This 
is an internal DB2 protocol error. 


| : Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS1 


ae End of Internal DB2 Information an 


System Action: The requester is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


DB2 Codes 4-209 


00E50077 — 00E50080 


Problem Determination: Using the SYS1.LOGREC entry and the 
associated SVC dump, determine the resource manager 
module that requested the execution unit switch. A resource 
manager should not request deletion of a service task and then 
attempt to execute under the same task. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50077 


Explanation: A deadlock condition was encountered. A 
request was made to either delete or synchronously execute a 
service task already participating in a chain of service tasks 
leading to the current request. This is an internal subsystem 
protocol error. 


fe —— Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS1, DSNVDSTO 


Lo End of Internal DB2 Information ee 


System Action: The requesting execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Using the SYS1.LOGREC entry and the 
associated SVC dump, determine the resource manager 
module that requested the function. If the recording FRR is 
EUS1FRRE, then the deadlock was detected by the execution 
unit switch service. Otherwise, the error was found during a 
delete service task request. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50078 


Explanation: A request was received to create a service task, 
but the service task controller is terminating. This code is also 
a subsystem termination reason code if the abend was issued 

by module DSNVCSTO. 


soe Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNVCSTO 


eee End of Internal DB2 Information id 


System Action: The requesting execution unit is terminated. 
The entire subsystem may also be terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Using the SYS1.LOGREC entry and 
associated SVC dump, determine the resource manager 
requesting the creation of a service task. DB2 was probably 
already terminating when this error was encountered. New 
service tasks cannot be created during subsystem termination. 


4-210 DB2 Messages and Codes 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50079 


Explanation: An invalid address space (ASCE) was specified 
as the target of an execution unit switch request. This can 
occur if the target is an allied address space or if the address 
space was concurrently undergoing termination. 


This abend code may also be issued when a passed agent ser- 
vices control block is determined to be invalid. 


| i Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS1, DSNVSR 


(oe Se End of internal DB2 information Aeros cet 


System Action: The requesting execution unit is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: Using the SYS1.LOGREC entry and the 
associated SVC dump, determine the resource manager 
module that requested the execution unit switch, suspend, 
resume, or cancel function. Using register 6 as a pointer to the 
execution block (EB), verify that the agent services control 
blocks — execution block (EB) and resource options block 
(ROB) — are valid. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50080 


Explanation: An execution unit (SRB or TCB) processor deter- 
mined that the current MVS Functional Recovery Routine (FRR) 
stack contained one or more eniries for FRR’s which should not 
exist. This check is made at the conclusion of a resource 
manager function executing under the SRB or TCB. 


[ee - Internal DB2 Information ~~ aa eae 


This error reason code is issued by the following CSECT(s): 
DSNVEUS2, DSNVEUSS. 


Ue eos See End of Internal DB2 Information eee 


System Action: An SVC dump is requested specifying an 
abend code of X'04E' and this reason code. The extraneous 
FRR entries are deleted from the stack. Execution continues. 
The application is not notified. 


Operator Response: Notify the system programmer of the SVC 
dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for problem reporting procedures. 


Problem Determination: MVS console data is logged and the 
SVC dump is taken. No record is written to SYS1.LOGREC. 


One or more resource manager functions created an FRR 
which was not deleted. Examine the current FRR stack in the 
PSA of the active CPU. The only valid stack entries are those 
established by DB2 and MVS Dump Services and, if DSNVEUS2, 
an entry established by that module. The format of the FRR 
stack is provided as data area FRRS in the appropriate MVS 
debugging guides. 


00E50081 


Explanation: A TCB execution unit processor determined that 
the list of active ESTAE exits associated with the TCB contained 
one or more entries for ESTAEs which should not be active. 
This check is made at the conclusion of a resource manager 
function executing under the TCB. 


Internal DB2 Information | 


This error reason code is issued by the following CSECT(s): 
DSNVEUSS. 


Dione aoe eats End of Internal DB2 Information aot ot ileal 


System Action: An SVC dump is requested specifying an 
abend code of X'04E' and this reason code. The extraneous 
ESTAE entries are deleted. Execution continues. The applica- 
tion is not notified. 


Operator Response: Notify the system programmer of the SVC 
dump. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for problem reporting procedures. 


Problem Determination: MVS console is logged and the SVC 
dump is taken. No record is written to SYS1.LOGREC. 


One or more resource manager functions created an ESTAE 
exit which was not deleted. Locate the TCB requesting the 
dump (It will be a DB2 service task in the home address space 
at the time the dump was requested.) Field TCBSTABB points 
to a. chain of STAE Control Blocks (SCB) for active exits. The 
only valid SCBs are for the ESTAE exit established (with a 
token) by DSNVEUSS3 and an ESTAI exit established when the 
task was created. SCBs are located in LSQA. The SCB format 
is provided as a data area in the appropriate MVS debugging 
guides. 


O00ESO100 


Explanation: The ASCE could not be found during recover 
stack processing. This is an internal subsystem error. 


: Internal DB2 Information | 


This abend reason code is issued by the following macro(s): 
DSNVRSTK 


batt Sateen End of Internal DB2 Information os etl 


System Action: The requesting recovery routine is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Using register 6 as the address of the 
execution block (EB), check that field EBPASCE contains a valid 


00E50081 — 00E50102 


ASCE address. Also determine the recovery module invoking 
the macro from the information provided by the SYS1.LOGREC 
entry and the associated SVC dump. 


Coliect the foliowing diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50101 


Explanation: The agent cancel function was unable to establish 
an ESTAE while preparing to cancel all active allied agents 
during processing of the -STOP DB2 MODE(FORCE) command. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNVAGCL 


ieee ee End of Internal DB2 information Sete Mes ates 


System Action: The abend is passed on to a subsystem 
support subcomponent (SSS) ESTAE. Probably, DB2 is 
abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: The inability to establish an 
ESTAE is normally due to insufficient free space in the local 
system queue area (LSQA) for an ESTAE control block (SCB). If 
necessary, increase the size of the system services address 
space. 


Problem Determination: Review the associated SVC dump for 
usage and free areas in the LSQA subpools belonging to the 
system services address space. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50102 


Explanation: An unrecoverable error occurred while canceling 
all active agents during processing of the -STOP DB2 
MODE(FORCE) command. This is a subsystem termination 
reason code. 


Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSNVAGCL 


| eee ee End of internal DB2 Information eee | 


System Action: The subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Review the SYS1.LOGREC entries for 
failures immediately preceding subsystem termination. Refer 
to “DB2 Abend Completion Codes (X'04E' and X'04F)” on 
page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


DB2 Codes 4-211 


600E50500 — 00E50701 


00E50500 


Explanation: An MVS LOCAL or CML lock could not be 
obtained during DB2 subsystem abnormal termination proc- 
essing. 


[ ce = 5o— oe Internal DB2 Information ~————— | 


This abend reason code is issued by the following CSECT(s): 
DSNVATRM 


eee ee End of internal DB2 Information oe Ras nod 


System Action: The execution unit is abended. The error is 
recorded on SYS1.LOGREC, and abnormal DB2 subsystem ter- 
mination is completed under a different execution unit if pos- 
sible. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Probiem Determination: A SYS1.LOGREC entry is requested. 
Reason code '00E50504' is placed in the SDWA variable 
recording area (VRA). The VRA data contains information 
about the status of subsystem termination at the time of error. 
For information about finding the SDWA, refer to Section 5 of 
Diagnosis Guide and Reference. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50501 


Explanation: An MVS local or CML lock could not be released 
during DB2 subsystem abnormal termination processing. 


| Interna! DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNVATRM 


eee och nies End of Internal DB2 Information ere | 


System Action: The execution unit is abended. The error is 
recorded on SYS1.LOGREC. DB2 subsystem termination is 
completed under a different execution unit if possible. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: A SYS1.LOGREC entry is requested. 
Reason code '00E50504' is placed in the SDWA variable 
recording area (VRA). The VRA data contains information 
about the status of subsystem termination at the time of error. 
For information about finding the SDWA, refer to Section 5 of 
Diagnosis Guide and Reference. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 
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00E50504 


Explanation: This reason code is used to define the format of 
the information recorded in the SDWA variable recording area 
(VRA) by the subsystem termination processor. The code iden- 
tifies additional information provided in the VRA for abends 
encountered in module DSNVATRM. 


7 Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNVATRR 


nor End of Internal DB2 Information ees 


System Action: Recording of the error encountered during 
subsystem termination continues. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: For information about finding the 
SDWA refer to Section 5 of Diagnosis Guide and Reference. 


00E50505 


Explanation: This reason code is used to define the format of 
the information recorded in the SDWA variable recording area 
(VRA). The code identifies additional information provided in 
the VRA for abends encountered in module DSNVATR4. 


[ internal DB2 Information oo 


This abend reason code is issued by the following CSECT(s): 
DSNVATRR 


a End of Internal DB2 Information ee 


System Action: Recording of the error encountered during 
subsystem termination continues. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: For information about finding the 
SDWA, refer to Section 5 of Diagnosis Guide and Reference. 


00E50701 


Explanation: A failure occurred during Commit Phase 1. This 
abend is used to effect abort, deallocation, and end-UR proc- 
essing. 


[ ~~ Internal DB2 Information se ee 


This abend reason code is issued by the following CSECT(s): 
DSNVEUS2, DSNVEUS3 


Lo End of Internal DB2 Information eee 


System Action: The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


Problem Determination: Standard DB2 diagnostic information 
may be obtained through SYS1.LOGREC and SVC dump mate- 
rials generated at the time of the abend. Register 6 contains 
the address of the active EB when the commit failed. The DB2 
global trace table contains an entry for the commit-UR function 
exit. The entry contains return and reason codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E50702 


Explanation: An error occurred while processing in SRB mode 
which could not be recovered. 


| Internal DB2 Information ~_ | 


This termination reason code is issued by the following 
CSECT(s): DSNVEUS2 


a eats End of Internal DB2 Information gee el 


System Action: The DB2 subsystem is abended with this 
reason code. 


Operator Response: Notify the system programmer and restart 
DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries looking for one or more DB2 abends immediately prior 
to the subsystem termination. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures and for 
information about dump analysis and service aids. 


Problem Determination: A DB2 dump of the original failure was 
requested by the recovery routine for DSNVEUS2 and a record 
written to SYS1.LOGREC. Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information about 
X'04F' and X'04E' abend completion codes. 


00E50703 


Explanation: This subsystem termination reason code is used 
following an error while attempting to resume a suspended 
execution unit. The successful completion of resume proc- 
essing was indoubt. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNVCSTO0, DSNVDSTO, DSNVEUS1, DSNVEUS3 


re End of Internal DB2 Information igesee Ae 


System Action: The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: DB2 diagnostic information may be 
obtained through SYS1.LOGREC and SVC dump materials gen- 


00E50702 — 00E50705 


erated at the time of the original error. Refer to “DB2 Abend 
Completion Codes (X'04E' and X'04F)” on page 1-6 for infor- 
mation about X'04F' and X'04E' abend completion codes. 


Coilect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50704 


Explanation: An error occurred in the DB2 Service Task Con- 
troller which could not be recovered. 


~ ” Internai DB2 Information | 


This termination reason code is issued by the following 
CSECT(s): DSNVEUS4 


bo End of Internal DB2 Information pe eae ed 


System Action: The subsystem is terminated with this reason 
code. Additionally, if no SDWA was provided to the recovery 
routine, a subsystem termination dump is requested. 


Operator Response: Notify the system programmer and restart 
DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries looking for one or more DB2 abends immediately prior 
to the subsystem termination. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures and for 
information about the SDWA, dump analysis, and service aids. 


Problem Determination: If an SDWA was available, a DB2 
dump of the original failure was requested and should be ana- 
lyzed to determine the nature of the original error. If no SDWA 
was available, the standard MVS SVC dump taken by sub- 
system termination must be analyzed. The Service Task Con- 
troller is the first descendant TCB of the job step TCB in the 
failing home address space. Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information about 
X'04F' and X'04E' abend completion codes. 


00E50705 


Explanation: A subsystem termination was requested because 
an agent was flagged as executing in 'must complete' mode or 
an execution unit holds a latch when neither condition should 
be true. Additionally, the subsystem termination may have 
been preceded by an abend with this reason code. 


[ Internal DB2 Information ~~ 


This termination reason code is issued by the following 
CSECT(s): DSNVEUS2, DSNVEUS3, DSNVEOT1 


eS octet End of Internal DB2 Information Pe hae 


System Action: The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries looking for one or more DB2 abends immediately prior 
to the subsystem termination. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 


DB2 Codes 4-213 


00E50706 — 00E50709 


Problem Determination: D8B2 diagnostic information may be 
obtained through SYS1.LOGREC and SVC dump materials gen- 
erated at the time of the original error. Refer to the accompa- 
nying abend code to determine the failure while in ' must 
complete' state. Refer to “DB2 Abend Completion Codes 
(X'04E' and X'04F)” on page 1-6 for information about X'04F' 
and X'04E' abend completion codes. 


If subsystem termination was requested by module DSNVEUS2, 
a standard MVS SVC dump will be generated. 


The 'must complete' indicator is bit ACEMC. Latch-held indi- 
cators are in field EBLTCHLD. Usually an invalid agent ‘must 
complete’ or latch-held condition is the result of a prior failure 
where the associated recovery routine did not perform correct 
resource cleanup. The condition may also occur if a resource 
manager function does not release all latches and/or reset the 
‘must complete' bit before returning control to either 
DSNVEUS2 or DSNVEUSS. 


00E50706 


Explanation: Either an unrecoverable error occurred while 
processing an End-of-Task condition on a DB2 service task or 
an asynchronous service task terminated for reasons other 
than an explicit “Delete Service Task” request. An abend with 
this reason code is requested if the latter situation occurs. 


[ ot ee = Internal DB2 Information ~——__— ~ | 


This termination reason code is issued by the following 
CSECT(s): DSNVEOT1 


Ls End of Internal DB2 Information 


System Action: The subsystem is terminated with this reason 
code. Additionally, if no SDWA was provided to the recovery 
routine, a subsysiem termination dump is requested. 


Operator Response: Notify the system programmer of the 
failure and restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries looking for one or more DB2 abends immediately prior 
to the subsystem termination. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures and for 
information about the SDWA, dump analysis, and service aids. 


Problem Determination: If an SDWA was available, a DB2 
dump of the original failure was requested and should be ana- 
lyzed to determination the nature of the original error. If no 
SDWA was available, the standard MVS SVC dump taken by 
subsystem termination must be analyzed. Refer to “DB2 Abend 
Completion Codes (X'04E' and X'04F)” on page 1-6 for infor- 
mation about X'04F' and X'04E' abend completion codes. 


00E50707 


Explanation: An ESTAE could not be established to protect a 
service task, the service task controller, or the recovery control 
task. This is a subsystem termination reason code. 


TO ~~ fnternal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNVEUS3, DSNVEUS4, DSNVEOT1, DSNVRCT 


iat tee End of Internal DB2 Information eee eee 


System Action: The DB2 subsystem is abended. 
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Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Review the usage and the free 
areas in the LSQA subpools of the two DB2 address spaces. If 
necessary, increase the private area size of the failing address 
space. Refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation about the VRA, dump analysis, and service aids. 
Problem Determination: If subsystem termination was 
requested by module DSNVRCT, a standard MVS SVC dump 
was requested. If insufficient private storage is the cause of the 
problem, other DB2 resource managers may have abended. 
Refer to “DB2 Abend Completion Codes (X'04E' and X'04F)” 

on page 1-6 for information about X'04F' and X'04E' abend 
completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


00E50708 


Explanation: An abend occurred while connecting an allied 
agent to the System Services address space. The connection 
must compiete so that the allied agent can be terminated. 


[ ee oe Internal DB2 Information a | 


This termination reason code is issued by the following 
CSECT(s): DSNVCONN 


ees End of Internal DB2 Information eae | 


System Action: The DB2 subsystem is terminated with this 
reason code. 


Operator Response: Notify the system programmer of the 
failure and restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries looking for one or more DB2 abends immediately prior 
to the subsystem termination. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures and for 
information about dump analysis and service aids. 


Problem Determination: A DB2 dump of the original error was 
requested and a record entered into SYS1.LOGREC. Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


00E50709 


Explanation: Subsystem termination was requested following a 
failure in a service task, the service task controller, or the 
recovery control task that could not be recovered by the ESTAE 
of the failing task. 


[ ~~ Internal DB2 information 7 | 


This reason code is issued by the following CSECT(s): 
DSNVSTAI 


| oe End of Internal DB2 Information eee | 


System Action: The DB2 subsysiem is abnormally terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. Deter- 
mine the registers and the failing task at the time of the error. 


Problem Determination: DB2 diagnostic information may be 
obtained through SYS1.LOGREC and SVC dump materials gen- 
erated at the time of the original error. Refer to “DB2 Abend 
Compietion Codes (X'04E' and X'04F)” on page 1-6 for infor- 
mation about X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50710 


Explanation: An abend occurred while disconnecting an allied 
agent from its home address space. The disconnect function is 
required before the agent can be connected to the Systems Ser- 
vices address space and then terminated. 


Internal DB2 Information ~ —S~<S aa | 


This termination reason code is issued by the following 
CSECT(s): DSNVDISC 


son. End of Internal DB2 Information ee ol 


System Action: The DB2 subsystem is terminated with this 
reason code. 


Operator Response: Notify the system programmer of the 
failure and restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries looking for one or more DB2 abends immediately prior 
to the subsystem termination. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures and for 
information about dump analysis and service aids. 


Problem Determination: A DB2 dump of the original error was 
requested and a record entered into SYS1.LOGREC. Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


00E50711 


Explanation: An error occurred in a Latch Manager function 
and the status of one or more execution units waiting for a latch 
is indoubt. The Latch Manager functional! recovery routine 
could not determine whether all waiting execution units had 
been resumed. 


[ Ee Internal DB2 Information | 


This termination reason code is issued by the following 
CSECT(s): DSNVLFRR 


He ee ee End of Internal DB2 Information _ 


System Action: The DB2 subsystem is terminated with this 
reason code. 


Operator Response: Notify the system programmer of the 
failure and restart DB2. 


00E50710 — 00E50715 


System Programmer Response: Scan the SYS1.LOGREC 
entries looking for one or more DB2 abends immediately prior 
to the subsystem termination. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures and for 
information about dump analysis and service aids. 


Problem Determination: A DB2 dump of the original error was 
requested and a record entered into SYS1.LOGREC. Refer to 
“DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information about X'04F' and X'04E' abend com- 
pletion codes. 


00E50713 


Explanation: The agent services recovery control task was 
entered in the suspend CANCEL exit. Subsystem termination 
was requested with this reason code. 


| Internal DB2 information = = | 


This reason code is issued by the following CSECT(s): 
DSNVRCT 


Nhe eee End of Interna! DB2 Information ee 


System Action: The DB2 subsystem is abnormally terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. It may be necessary to 
analyze the MVS SVC dump requested by the subsystem termi- 
nation processor. Refer to Section 5 of Diagnosis Guide and 
Reference for failure analysis procedures and for information 
about dump analysis and service aids. 


Problem Determination: An MVS SVC dump was requested by 
the subsystem termination processor. Refer to “DB2 Abend 
Completion Codes (X'04E' and X'04F)” on page 1-6 for infor- 
mation about X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


00E50715 


Explanation: Subsystem termination was requested following 
an unrecoverable error in a DB2 SRB mode execution unit. 


| Internal DB2 Information 2 aoe aa 


This reason code is issued by the following CSECT(s): 
DSNVRCT 


(eee End of internal DB2 Information See = 2s) 


System Action: The SRB-related task was abended as a result 
of SRB to TCB percolation. The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: D8B2 diagnostic information may be 
obtained through SYS1.LOGREC and SVC dump materials gen- 


DB2 Codes 4-215 


00E50717 — 00E50727 


erated at the time of the original error. Refer to “DB2 Abend 
Completion Codes (X'04E' and X'04F)” on page 1-6 for infor- 
mation about X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50717 


Explanation: The subsystem was terminated, because 
resource manager ESTAE exits could not be purged for the 
default service task. 


iar Internal DB2 Information ae Gl 


This reason code is issued by the following CSECT(s): 
DSNVEUS3 


Use ae End of Internal DB2 Information eee: 


System Action: The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: If an abend preceded the subsystem 
termination request, DB2 diagnostic information may be 
obtained through SYS1.LOGREC and SVC dump materials. 
Refer to “DB2 Abend Completion Codes (X'04E' and X'04F)” 
on page 1-6 for information about X'04F' and X'04E' abend 
completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00E50719 


Explanation: A failure occurred in a service task, the service 
task controller, or the recovery control task and was not recov- 
ered by the ESTAE of the failing task. No SDWA was provided 
to the ESTAE exit. This is a subsystem termination reason 
code. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNVSTAI 


er End of internal DB2 Information Be ees fe 


System Action: The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. Register 
3 contains the abend code of the original error. 


Problem Determination: Module DSNVSTAI was unable to gen- 
erate a standard DB2 SYS1.LOGREC entry and SVC dump, 
because system diagnostic work area (SDWA) was not provided 
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by the recovery termination management (RTM) facility of MVS. 
An MVS SVC dump was requested by system termination. To 
determine the location of the error, examine the RB structure of 
the failing TCB. 


DB2 diagnostic information may have been obtained by other 
recovery routines if an abend preceded the subsystem termi- 
nation request. Refer to “DB2 Abend Completion Codes 
(X'04E' and X'04F)” on page 1-6 for information about X'04F' 
and X'04E' abend completion codes. . 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1,3, 5. 


00E50725 


Explanation: Subsystem termination was requested because of 
an unrecovered error in a DB2 scheduled SRB-mode execution 
unit. 


[ ae ea internal DB2 Information : Resins | 


This reason code is issued by the following CSECT(s): 
DSNVRCT 


[| End of Internal DB2 information ee ae 


System Action: The SRB-related task DSNVRCT was abended. 
due to SRB to TCB percolation. The DB2 subsystem is 
abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. If necessary, analyze the 
MVS SVC dump requested by subsystem termination. Refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures and for information about dump analysis and 
service aids. 


Problem Determination: DB2 diagnostic information may be 
obtained through SYS1.LOGREC and SVC dump materials 
obtained as a result of abends occurring prior to subsystem ter- 
mination. Refer to “DB2 Abend Completion Codes (X'04E' and 
X'O4F)” on page 1-6 for information about X'04F' and X'04E' 
abend completion codes. 


An MVS SVC dump was requested by system termination. To 
determine the location of the error, examine the RB structure of 
the failing TCB. Register 1 contains the original SRB abend 
code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1,3, 5. 


00E50727 


Explanation: A secondary failure occurred during agent ser- 
vices functional recovery processing. This is a subsystem ter- 
mination reason code. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNVEUS1, DSNVEUS2, DSNVSTAI, DSNVEOT1, DSNVDSTO 


[as Seen End of Internal DB2 Information eT 


System Action: The DB2 subsystem is abended. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for one or more DB2 abends occurring immediately 
prior to the subsystem termination. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. Deter- 
mine the functional recovery routine that failed and the regis- 
ters at the time of the error. 


Problem Determination: DB2 diagnostic information may be 
obtained through SYS1.LOGREC and SVC dump materials gen- 
erated at the time of the original error. If the subsystem termi- 
nation request was issued by module DSNVEUS2, an MVS SVC 
dump was requested. Refer to “DB2 Abend Completion Codes 
(X'04E' and X'04F)” on page 1-6 for information about X'04F' 
and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


DB2 Codes 4-217 


00E60000 — 00E60088 





instrumentation Facility Codes (X'E6') 


This section includes Instrumentation Facility 
Abend (IFC) Codes. 


O00E60000 


Explanation: This reason code is used to indicate that informa- 
tion has been added to the SDWA Variable Recording Area 
(VRA) following the data provided by the DSNWRCRD service. 
This is done so that anyone examining a SYS1.LOGREC entry 
can determine, from the reason code, what additional data has 
been placed in the VRA. The reason code is the first data item 
in the VRA, as mapped by macro IHAVRA. 


| Internal DB2 Information —< 3 “| 


This abend code is issued by the following CSECT(s): 
DSNWVCM1 


espns ee End of Internal DB2 Information i= eed 


System Action: The command being processed, failed. The 
DB2 subsystem remains operational. 


Problem Determination: The Diagnostic Data Table (DSNDDDT 
control block) should appear in the SDWA Variable Recording 
Area. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 


00E60008 


Explanation: This reason code is used to indicate that MVS 
and DB2 dispatching units do not match. There is an internal 
DB2 dispatching unit problem which should not occur. 


| Internal DB2 Information | 


This abend code is issued by the following CSECT(s): 
DSNWVAPR 


ae End of Internal DB2 Information Pee | 


System Action: The function being traced is abended. The DB2 
subsystem remains operational and the functional recovery of 
TRACE will retry if possible. 


Problem Determination: The probiem is either the ASID of EB 
primary (EBPASCE->ASCE->ASID) did not match the the EPAR 
ASID, or the ASID of the EB home (EBHASCE->ASCE->ASID) 
did not match the MVS home dispatching unit 
(PSAAOLD->ASCB->ASID), or the PSATOLD did not match the 
EBEXU field. Analyze the dump and previous SYS1.LOGREC 
entries do isolate the cause of the problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


OOE60086 


Explanation: An internal logic problem occurred trying to 
obtain the MVS CML lock. 


aa ~ Internal DB2 Information ee 


This abend reason code is issued by the following CSECT(s): 
DSNWARDA, DSNWVOPX 


aoe eee End of Interna! DB2 tnformation eee 


System Action: The request is abended. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Request the SYS1.LOGREC 
and SVC dump. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


00E60087 


Explanation: An internal error occurred attempting to free the 
MVS CML lock. 


ee Internal DB2 Information aaa 


This abend reason code is issued by the following CSECT(s): 
DSNWARDA, DSNWVOPX 


een End of Internal DB2 Information eae 


System Action: The request is abended. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Request the SYS1.LOGREC 
and SVC dump. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: This error is an internal error. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


OOEGONSS 


Explanation: An internal logic problem occurred on a READS 
request. The event is being traced asynchronously, which is not 
allowed. 


DB2 Codes 4-219 


00E60199 — O00E60888 


[ Er Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNWVSR2 


a End of Internal DB2 Information eters eee 3 


System Action: The request is abended. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Request the SYS1.LOGREC 
and SVC dump. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: This is an internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5. 


00E60100 through 00E60199 


Explanation: The reason codes 00E60100 through 00E60199 are 
used by the instrumentation facility component (IFC) when a 
trace event occurs for which IBM service personnel have 
requested a dump using the IFC selective dump service aid. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNWVAPR 


fee End of Internal DB2 Information ees 


System Action: The abending agent might be retried or termi- 
nated, depending upon the serviceability dump request. 


Problem Determination: The abend is issued on the occur- 
rence of a specified trace event. A SVC dump is taken to the 
SUS1.DUMPxx data set. Problem determination methods 
depend on the condition that IBM service personnel are 
attempting to trap. 


QOEG0886 


Explanation: This reason code is used to indicate that an 
invalid IAMQ function was passed to module DSNWVZXT. This 
problem should not occur. 


a ~~ Internal DB2 Information 


This abend code is issued by the following CSECT(s): 
DSNWVZXT 


Li  End of internal DB2 Information sd 


System Action: The function requested is abended. The DB2 
subsystem remains operational and the functional recovery will 
retry if possible. 


Problem Determination: The !AMQ function requested does not 
match a function handled by DSNWZXT. Analyze the dump and 
previous SYS1.LOGREC entries do isolate the cause of the 
problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 
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00E60887 


Explanation: The reason code is set by the Instrumentation 
Statistics Facility FRR routine when an abend condition occurs 
during statistics gathering. The reason code only appears in the 
VRA data of SYS1.LOGREC to indicate the WWAB block exists in 
the variable recording area following the standard DB2 informa- 
tion. 


[ ~~ _ Internal DB2 Information Eran | 
This code is issued by the following CSECT(s): DSNWVZSS 


fo End of Internal DB2 Information ghee ne 


System Action: Depending on the number of errors the Instru- 
mentation Statistics Facility may be turned off. The FRR will 
attempt a retry to RTM to keep the DB2 subsystem operational. 


System Programmer Response: The recovery routine for the 
CSECT issuing this reason code records information in the vari- 
able recording area (VRA). Refer to Section 5 of Diagnosis 
Guide and Reference for more information on the VRA. 


Problem Determination: Normally the standard SYS1.L.OGREC 
entries provide the necessary information to isolate the failing 
module. The WWAB control block in the variable recording area 
provides the resource manager RMID fast called (WWABRMID) 
and the RMID of which resource manager Instrumentation Sta- 
tistics Facility called when the failure occurred (WWABFRMS). If 
WWABFR\MS is binary zero, then the error occurred in the 
instrumentation Statistics Facility. 





OOE60888 


Explanation: The reason code is set by the Instrumentation 
Accounting Facility FRR routine when an abend condition 
occurs during the accounting function. The reason code only 
appears in the VRA data of SYS1.LOGREC to indicate the 
WWAB block exists in the variable recording area following the 
Standard DB2 information. 


System Action: Depending on the number of errors the Instru- 
mentation Accounting Facility may be turned off. The FRR will 
attempt a retry to RTM to keep the DB2 subsystem operational. 


i Internal DB2 Information a al 
This code is issued by the following CSECT(s): DSNWVZSA 


eer End of internal DB2 Information pce seca 


System Programmer Response: The recovery routine for the 
CSECT issuing this reason code records information in the vari- 
able recording area (VRA). Refer to Section 5 of Diagnosis 
Guide and Reference for more information on the VRA. 


Problem Determination: Normally the SYS1.LOGREC standard 
entries provide the necessary information to isolate the failing 
module. The WWAB contro! block in the variable recording area 
provides the resource manager RMID last called (WWABRMID) 
and the RMID of which resource manager Instrumentation Sta- 
tistics Facility called when the failure occurred (WWABFRMS). if 
WWABFR\MS is binary zero, then the error occurred in the 
Instrumentation Accounting Facility. 








instrumentation 


Facility Interface (IFl) Reason Codes (X'E6') 


This section contains the Instrumentation Facility 
(IFl) Reason Codes. 


00E60800 


Explanation: The command was completed, but the return area 
was not large enough to accommodate all the output messages. 
The return area contains the last complete message segment 
that fit. The IFCABM field in the IFCA indicates the number of 
bytes moved to the return area. The IFCABNM field in the IFCA 
indicates the number of bytes which were not moved because 
the return area was too small. 


| ss Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWACMD 


ee End of Internal DB2 information Baise on 


User Response: Allocate more storage for the return area, if 
desired, and reissue the request. 


00E60801 


Explanation: The command was partially completed, but an 
internal error was encountered. Check the return area for a 
message. 


| Internal DB2 Information pone te eal 


This reason code is issued by the following CSECT(s): 
DSNWACMD 


[End of Internal DB2 Information _____ | 


User Response: Dependent upon the message in the return 


area. 


00E60802 


Explanation: The instrumentation facility request was partially 
completed, but the return area was not large enough to accom- 
modate ail the output. The return area contains the last com- 
plete record that fit. The IFCABM field in the IFCA indicates the 
number of bytes moved to the return area for the READS or 
READA request. The IFCABNM field in the IFCA indicates the 
number of bytes that could not fit in the return area. 


| = Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNWARDA 


{ End of Internal DB2 Information ee ca 





00E60800 — 00E60806 


User Response: Allocate more return area storage and 
reissue the request. 


00E60803 


Explanation: No data was returned from the READA request 
because none was available. Either the OPn storage buffer was 
empty or the application program had already retrieved all the 
trace records. 


| Internal DB2 Information a= 7 


This reason code is issued by the following CSECT(s): 
DSNWARDA 


ie rete ore End of Internal DB2 Information bees te 


User Response: None. No data existed to be read. 


00E60804 


Explanation: No data was returned from the READS or READA 
request. This could be because: 


¢ The destination OPx value specified in the IFCA was not 
active for a READA request. 

¢ The qualification information specified did not match a 
process for a READS request. 

* No information was available for a READS request. 


| at Internal DB2 Information "eG | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI, DSNWARDA, DSNWALCK 


eres End of Internal DB2 information eee 


User Response: If the OPn destination was not active, then 
activate the OPn destination or issue the request using an OPn 
destination that is active. 


00E60805 


Explanation: The request for information resulted in an abend. 


i ~~~ _ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNWAAPI 


Deere ee he! End of Internal DB2 Information pinieaecos 2 


User Response: Dependent upon the abend code in the log 
record. 


Problem Determination: See log record for abend code. 


OOE60806 


Explanation: The request for information resulted in an abend, 
perhaps because one of the parameters on the call was invalid. 
lf a SYSUDUMP or SYSABEND DD statement is present in your 
JCL, you will receive an abend dump. 


DB2 Codes 4-221 


00E60807 — 00E60825 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNWAAPI 


Ss at ot ees End of Internal DB2 Information eee: 


User Response: Dependent upon the abend code. 


Problem Determination: See abend code in abend dump or log 
records. 


00E60807 


Explanation: The request for information resulted in an abend, 
possibly because either the ACE token passed was invalid or 
became invalid during processing. In this case, no SDUMP is 
taken and contro! returns to the application program. 


a ; Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNWAAPI 


a End of Internal DB2 Information rere 


User Response: If your application program does not pass a 
token, you can reissue the previous IFI request from the appli- 
cation program. 


Problem Determination: Ifthe application program passes an 
ACE token, the token is probably invalid. 


00E60808 


Explanation: The request for information resulted in an abend. 
Perhaps a DB2 structure became invalid while your application 
program was using it. 


a = king Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNWAAPI 


We rege End of Internal DB2 Information exe Me til 


User Response: To reduce the chance of this occurring, issue 
requests from a task with a higher priority than DB2 and its 
users. Certain requests (for example, a READS for IFCIDs 0147 
and 0148) are more likely to encounter this type of problem. 
The request may be reissued. No SDUMP is taken and control 
is returned to the application program. 


00E60820 


Explanation: The command request did not complete normally. 
Check the IFCABM field in the IFCA to see if any message seg- 
ments have been returned. There are many reasons for this 
condition, including: 


* Command authorization failure 

¢ Command processor abend 

¢ Command syntax error 

¢ Command output limit being exceeded. 


4-222 DB2 Messages and Codes 








| 
| 


[ a Interna! DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNWACMD 


———————— End of Internal DB2 Information eee] 


Problem Determination: To determine the reason for the 
failure, analyze the message or messages that are returned. 


00E60821 


Explanation: The request was not processed because a speci- 
fied IFCID is not valid for the READS or WRITE function. 


| Internal DB2 Information fs | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


peared ee End of Internal DB2 Information fo et) 


User Response: Remove or replace the invalid IFCID. 


Problem Determination: Check the IFCA diagnostic area 
(IFCAD) for the IFCID in error. 


00E60823 


Explanation: The WRITE request was not processed because 
the IFCID specified was not active. 


f — Internal DB2 Information 7 7 dl 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


ar End of Internal DB2 Information sd 


User Response: 
a different IFCID. 


Activate the IFCID or reissue the request with 


00E60824 


Explanation: An authorization failure occurred. On a READA 
request, the ownership token specified did not match the owner 
of an active trace or the user did not have the correct monitor 
authority. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWARDA DSNWARDS 


re a End of Internal DB2 Information So ee eal 


User Response: Reissue the request with the correct owner- 
ship token for the desired OPn destination or obtain the appro- 
priate monitor authority, as needed. 


Problem Determination: Examine the specified ownership 
token and the monitor authority of the user. 


00E60825 


Explanation: Stack storage was not available for copying the 
output area. 


| Interna} DB2 Information : 


This reason code is issued by the following CSECT(s): 
DSNWAAPI, DSNWARDS 


ee End of internal DB2 Information dee toe | 


00E60826 


Explanation: On a READA request, the destination specified 
did not match a valid destination. 


| ~——~—~_ Internal DB2 Information Tee | 


This reason code is issued by the following CSECT(s): 
DSNWARDA 


Ce eee End of internal DB2 Information eee 


User Response: Reissue the request using a valid destination. 


00E60827 


Explanation: On a READA request, the destination specified 
did not have an instrumentation facility buffer assigned. The 
application program must start a trace to the destination speci- 
fied before attempting a READA request. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWARDA 


Le End of Internal DB2 Information eas 


User Response: Start a trace to the desired destination, and 
reissue the request. 


00E60828 


Explanation: Ona READS request, storage was not available 
for the IRLM inquiry request. 


i> Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWALCK 


oe tere End of Internal DB2 Information aoe ee 


00E60829 


Explanation: On a READS request, an unexpected return code 
was received from IRLM. 


[ ~ Internal DB2 Information i ; | 


This reason code is issued by the following CSECT(s): 
DSNWALCK 


[eee eee End of Internal DB2 Information eer 








00E60826 — 00E60841 


00E60830 


Explanation: An unexpected return code was received ona 
READS request. 


| a Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWARDS 


expen: End of Internal DB2 information ee ees 


User Response: Reissue the request. If the condition persists, 
contact your IBM support center and tell them the message you 
are encountering. 


00E60831 


Explanation: A number of abends have occurred, stopping any 
IFl request. 


| Internal DB2 Information y meee | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


a es End of Internal DB2 Information Bea 


User Response: Issue a -START TRACE to clear the condition. 
Contact your IBM support center and tell them that numerous 
abends are causing an abnormal condition to occur. 


00E60832 


Explanation: The IFC!D specified on a READS was not active. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


ete End of Internal DB2 Information cee 


User Response: Issue a -START TRACE for monitor class 1. 


00E60840 


Explanation: An invalid function was specified. The function 
specified does not match one of the IFl supported functions. 


Ges. — Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


ee te End of Internal DB2 Information Po 


User Response: Correct the function field of the DSNWLI call 
so that it is WRITE, READA, READS, or COMMAND. 


00E60841 


Explanation: The IFCA was specified incorrectly. The return 
code and reason code will be placed at the correct offset in the 
erroneous IFCA. The IFCA length might be invalid, or the IFCA 
eye-catcher (IFCAID) might be missing. 
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00E60842 — 00E60847 


| : Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


eso ee End of Internal DB2 Information _ 


User Response: Examine the length of the IFCA and the eye- 
catcher field of the IFCA. Correct any mistakes. 


Problem Determination: See the return and reason codes 
placed at the correct offset in the erroneous IFCA. 


00E60842 


Explanation: The return area was specified incorrectly. The 
length might be invalid. The length of the return area is a 
fullword rather than a halfword, and the valid range is from 
X'000000064' to X'00020000' . 


Internal DB2 information 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


[eee ee eee End of Internal DB2 Information ee 


User Response: 
to the valid range. 


Respecify the return area length to conform 


00E60843 


Explanation: The IFCID area was specified incorrectly. The 
length might be invalid. The valid range is from X'0006' to 
X'0044'. 


Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


[oe ee End of Internal DB2 Information ae eeeeah 


User Response: Respecify the IFCID area length field to 
conform to the valid range. 


Problem Determination: Examine the length field of the IFCID 
area. 


00E60844 


Explanation: The qualification area was specified incorrectly. 
The length might be invalid, or the WQAL eye-catcher 
(WQALEYE) might be missing. 


[ aie Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


fected te oa End of internal DB2 Information eee pal 
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User Response: Correct any incorrect specification of the 
qualification area length and eye-catcher fields. 


Problem Determination: Examine the length and eye-catcher 
fields of the qualification area. 


00E60845 


Explanation: An iFCID specified for a READS or a WRITE 
request was invalid. 


| area Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


Le End of Internal DB2 Information ieee ct] 


User Response: Replace the errant IFCID with a valid one or 
remove it from the request. 


Problem Determination: Check the IFCA diagnostic area for 
the IFCID in error. 


00E60846 


Explanation: The output area was specified incorrectly. 


| ~ - internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


{| seEnd of Internal DB2 Information id 


User Response: Correct either the output area length or the 
output area parameter on the DSNWLI call, depending on which 
one is in error. 


Problem Determination: The length might be invalid; the valid 
range is from X'000A' to X'1000'. Also, the output area param- 
eter on the DSNWLI call may have been specified as zero. The 
output area parameter must point to a valid output area. 


00E60847 


Explanation: The buffer information area was specified incor- 
rectly. 


| internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNWAAPI 


eth ts End of Internal DB2 Information es 


User Response: Check that the buffer information area has an 
eye-catcher value of 'WBUF' and a Jength value equal to the 
length of 'WBUF' and correct any invalid values. 


Problem Determination: The length might be invalid, or the 
'WBUF' eye-catcher might be missing. 


00E70004 — 00E70007 





Relational Data System Codes (X'E7') 


00E70004 


Exptanation: An inconsistency has been detected in the sub- 
system catalog tables. 


: Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNXOCK, DSNXOLV 


[ees iogae eee! End of Internal DB2 Information pee ee 


System Action: The application program abends. 


Operator Response: Notify the system programmer or data- 
base administrator. 


System Programmer Response: Notify the database adminis- 
trator if appropriate. Otherwise, use the information under the 
Problem Determination section to resolve the problem. 


Problem Determination: The module name and the name of the 
inconsistent subsystem catalog table can be found in the 
SQLCA. The SQLCA is pointed to by RDASQLCA, which is 
pointed to by register 7. Register 7 is the cursor table pointer 
and is always restricted entirely over the relational data system 
(RDS) subcomponent. Dump the page set containing the incon- 
sistent subsystem catalog using the DUMP option of the REPAIR 
utility. For information about how to use the REPAIR utility, 
refer to Section 4 of Diagnosis Guide and Reference. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 47. 


00E70005 


Explanation: A relational data system (RDS) subcomponent 
internal inconsistency has been detected. 


ae =. internal DB2 Information fetes | 


This abend reason code is issued by the following CSECT(s): 
any of the RDS modules 


Wee ees End of Interna! DB2 Information pee sil 


System Action: The application program abends. 
Operator Response: Notify the system programmer. 


System Programmer Response: Use the information in the 
Problem Determination section of this message to resolve the 
problem. Refer to Section 5 of Diagnosis Guide and Reference 
for information about failure analysis procedures. 


Problem Determination: The abend code may be issued by any 
of the RDS modules. The module name can be found in the 
SQLCA. SQLERRD1 in the SQLCA contains a unique code that 
identifies the location within the module when the error is 
detected. SQLERRM may contain some meaningful information 
for that particular error. 


Refer to the 'Problem Determination' section for code 
‘00E70004' for information about how to find the SQLCA. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 13. 


00E70006 


Explanation: An internal inconsistency has been reported to 
the relational data system (RDS) subcomponent by the RDS 
subcomponent of DB2. 


| Internal DB2 Information ~~ o> ee 


This abend reason code is issued by the following CSECT(s): 
Any of the RDS interpreter modules. 


Vises Sead aes End of internal DB2 Information fee ee 


System Action: The application program abends. 
User Response: Notify the system programmer. 


Operator Response: Provide a print of the SVC dump to the 
system programmer. 


System Programmer Response: Use the information in the 
‘Problem Determination' section of this message to resolve the 
problem. 


Problem Determination: The abend code may be issued by any 
of the RDS interpreter modules (DSNX...). The module name 
appears in the SQLCA. SQLERRD1 in the SQLCA contains a 
unique code that identifies the location within the module at 
which the error was detected. SQLERRM contains information 
describing the particular error. 


Refer to the 'Problem Determination' section for code 
'00E70004' for information about how to find the SQLCA. 


Coilect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 3. 


00E70007 


Explanation: A bad application-supplied address was encount- 
ered while trying to copy SQLCA back to the application 
program. 


= ~~~ _ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNXERD 


(ees End of internal DB2 Information Seen 


System Action: The application program abends. 


System Programmer Response: Contact the application pro- 
grammer. 


DB2 Codes 4-225 


00E70008 — 00E7000C 


Problem Determination: The register contents at the time of 
abend are as follows: 


R2 A decimal code identifying the data: 


1 FRB address is bad. 

2 FRBPARM has the bad address used to locate the 
RDIIN. 

18 RDICODEP has the bad address used to locate 
the SQLCA. 


R3 The bad application data area address. 

R4 The length of the data. 

R5 The key of the data. 

R8 The address of the FRB in the application address space 
(RDIIN). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4 or 22. 


00E70008 


Explanation: Not enough storage to continue the sort process. 


| : Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNXSTS DSNXSTSG DSNXSORI 


[ea eee End of Internal DB2 Information _ 


System Action: The application program abends. 
Operator Response: Notify the system programmer. 


System Programmer Response: Contact the application pro- 
grammer. 


Problem Determination: The SQLCA is formatted, and an SQL 
return code of -904 is returned to the user. A return code with a 
value of 16 was returned from the Sort subcomponent. Check 
the SYSOUT message file for any errors detected by the Sort 
subcomponent. Check the SQLCA for any messages detected 
by the Sort subcomponent input/output exit routines. 


00E7000C 


Explanation: The application program supplied an invalid 
address. 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNXECP, DSNXEDC, DSNXRIVB, DSNXROUT 


eens End of Internal DB2 Information eee) 


System Action: The application program abends. 


User Response: Correct the invalid address. See Problem 
Determination for instructions on how to determine the failing 
SQL statement and the bad address. Use this information to 
determine the application’s incorrect setting of the address. 


Operator Response: Notify the user or system programmer. 


System Programmer Response: Assist the user in determining 
the invalid address. 
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Problem Determination: 
At the time of abend the register contents are: 


R2 A decimal code identifying the bad data: 


1 (1) The bad FRB address used to locate the 
FRBPARM. 

2 (2) FRBPARM has the bad address used to 
locate the RDIIN. 

3 (3) RDIVPARM has the bad address used to 
locate the SQLDA length. 

4 (4 RDIVPARM has the bad address used to 
locate the SQLDABC. 

5 (5) -RDIVPARM has the bad address used to 
locate the SQLDA length. 

6 (6) RDIAUXPA has the bad address used to 
locate the SQLDA length. 

7 (7) RDIAUXPA has the bad address used to 
locate the SQLDABC. 

8 (8) PVDPTR has the bad address used to 
locate the data variable. 

9 (9) PVINFO has the bad address used to 


locate the indicator variable. 


10 (A) Either RDIVPARM or RDIAUXPA has the 
bad address used to locate the PVARS 
structure. 

11 (B) RDIAUXPA has the bad address used to 
locate the SQLN. 

12 (C) RDIAUXPA has the bad address used to 
locate the SQLDAID. 

13 (D) RDIAUXPA has the bad address used to 
locate the SQLDABC. 

14 (E) RDIAUXPA has the bad address used to 
locate the SQLD. 

15 (F) RDIAUXPA has the bad address used to 
locate the SQLVAR. 

16 (10) PVINFO has the bad address used to 
jocate the indicator variable. 

17 (11) PVDPTR has the bad address used to 
locate the data variable. 

18 (12) PVDPTR has the bad address used to 
locate the data variable. 

19 (13) PVDPTR has the bad address used to 


locate the data variable. 

R3 The bad data address. 

R4 The length of the data. 

R5 The key of the data. 

R8& The address of the RDIIN. This is the application’s invo- 
cation parameter list. The address of the RDIIN might 
not be valid when the RDIIN cannot be located (Register 
2or1or 2). 


The program name identifies the failing program. The state- 
ment number refers to the statement number in the DB2 pre- 
compiler listing. The SQL statement executed can then be 
found in the application program’s compiler/assembler listing. 
For example, if the statement number is X'00E6', refer to state- 
ment number 230 in the DB2 precompiler listing. This precom- 
piler statement number can be cross-referenced to the 
program’s compiler/assembler listing. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 4 or 22. 


Use the following offsets to trace through the control blocks. 


PVARS: 

Offsets Len Description 

0 (0) 4 LENGTH OF BLOCK 

4 (4) 12 PVENTRY, OCCURS 
ONCE FOR EACH HOST 
VARIABLE IN THE SQL 
STATEMENT 

PVENTRY: 

Offsets Len Description 

0 (0) 2 COLUMN TYPE 

4 (4) 4 PVDPTR, POINTER TO 
HOST VARIABLE DATA 

8 (8) 4 PVINFO, POINTER TO 
INDICATOR 

FRB: 

Offsets Len Description 

0 (0) 4 BLOCK IDENTIFIER 
'FRB' 

4 (4) 2 RAL ENTRY NUMBER 

6 (6) 2 FVL ENTRY NUMBER 

8 (8) 4 FRBPARM, POINTER 
TO PARAMETER LIST 
(RDIIN) 

12 (C) 2 PARAMETER COUNT 

14 (E) 2 RETURN CODE 

16 (10) 4 REASON CODE 

20 (14) 4 FEEDBACK 

24 (18) 4 PRH PC LX/EX VALUE 

28 (1C) 2 REQUEST QUALIFIER 
VALUE 

30 (1E) 2 RESERVED 

32 (20) 0 END OF USER FRB 
SECTION 

RDIIN: 

Offsets Len Description 

0 (0) 2 PARM LIST BEGIN 

2 (2) 2 FLAGS 

4 (4) 2 CALL TYPE 

6 (6) 8 PROGRAM NAME 

14 (E) 8 TIMESTAMP 

22 (16) 2 SECTION # 

24 (18) 4 PTR TO ERROR CODE 
STRUCTURE 

28 (1C) 4 RDIVPARM PTR TO 
USER INPUT VARI- 
ABLES (PVARS STRUC- 
TURE) 

32 (20) 4 RDIAUXPA PTR TO DB2 
RETURN VARIABLES 
(PVARS STRUCTURE) 

36 (24) 2 STATEMENT # 

38 (26) 2 STATEMENT TYPE 

00E7000F 


Explanation: A deadiock condition has been detected. 


OOE7000F — 00E70011 


| Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNXIDPM 


ae End of Internal DB2 Information ee | 


System Action: The requested operation is not performed. 
User Response: Rerun the application. 


System Programmer Response: /f the deadlock condition 
becomes chronic, examine the mix of applications running to 
determine why the deadlock is occurring. 


Problem Determination: The requested operation is not per- 
formed. Message DSNT375I is issued and a SQL return code of 
-904 is issued. For more information, refer to the SQL code or 
to the description of the DSNT375!1 message. 


00E70010 


Explanation: A timeout condition has been detected. 


Internal DB2 Information me | 


This abend reason code is issued by the following CSECT(s): 
DSNXIDPM 


Use eta End of Internal DB2 Information eee 


System Action: The requested operation is not performed. 
User Response: Rerun the application. 


Problem Determination: The requested operation is not per- 
formed. Message DSNT376! is issued and a SQL return code of 
-904 is issued. For more information, refer to the SQL code or 
to the description of the DSNT376i message. 


00E70011 


Explanation: During an authorization check for plan or 
command authorization, an execution unit switch took place to 
a new execution unit and the new execution unit abended. 


if 7 3 Internal DB2 Information ~ Oa <8 | 


This abend reason code is issued by the following CSECT(s): 
any module that invokes the DSNXCHK macro 


Vee ccc ete End of Internal DB2 Information | 


System Action: The calling execution unit is also abended. 


Operator Response: Notify the system programmer. Print 
SYS1.LOGREC. Also print the dump from any previous dump 
data set if the failing module name is DSNXACKP or the dump 
title is 'RDS AUTHCHK'. 


System Programmer Response: See problem determination 
and refer to Section 5 of Diagnosis Guide and Reference for 
failure analysis procedures. 


Problem Determination: The module issuing this abend reason 
code has invoked the DSNXCHK macro to perform an authori- 
zation check for either the application plan or the command 
authorization. The DSNXCHK macro does a cross-memory exe- 
cution unit switch to module DSNXACKP. Look for a previous 
dump in which the failing module name is DSNXACKP, the 


DB2 Codes 4-227 


00E70012 — 00E70058 


dump title is RDS AUTHCHK, or the failure is an allocation 
failure. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5. 


00E70012 


Explanation: A user exit has written beyond the end of the 
output buffer. 


[ Internal DB2 Information Taree | 


This abend reason code is issued by the following CSECT(s): 
DSNXRPCC 


De a oe End of Internal DB2 Information of Baste sll 


System Action: The application program abends. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Correct the exit routine. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: At the time of abend the register con- 
tents are: 


e R2 contains the first 4 characters of the exit routine name. 
¢ RS contains the next 4 characters of the exit routine name. 


If the exit routine name is DSNXVDTX then DECPDLEN contains 
the LOCAL DATE LENGTH specified on the DB2 Installation 
Application Programming Defauits Panel. The exit routine 
wrote beyond this length in returning a local date format to 
DB2. 


If the exit routine name is DSNXVTMX then DECPTLEN contains 
the LOCAL DATE LENGTH specified on the DB2 Installation 
Application Programming Defaults Panel. The exit routine 
wrote beyond this length in returning a local time format to DB2. 


00E70013 


Explanation: DRDS at the server site supplied an invalid 
address. 


| — Internal DB2 Information i - | 


This abend reason code is issued by the following CSECT(s): 
DSNXECP, DSNXEDC, DSNXRIVB, DSNXROUT 


Veit 2a aie End of Internal DB2 Information ee ne 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. 


Operator Response: Notify the system programmer. 
System Programmer Response: This is a DB2 internal error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 5, 13. 


00E70018 


Explanation: An internal inconsistency has been detected by 
the SORT subcomponent. 


4-228 DB2 Messages and Codes 


| op wee he Internal DB2 Information ~~ meee i 


This abend reason code is issued by the following CSECT(s): 


DSNXSORI DSNXSTS DSNXSTSG 
DSNXSIN DSNXSING DSNXSMR 
DSNXSRMG DSNXSWFM DSNXSTRG 
DSNXSTM 


Nee ete End of internal DB2 Information eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 
System Programmer Response: This is a DB2 internal error. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: Sort has set the registers as follows: 


¢ R2 points to the SRTCOMM. 
¢ R3 is a unique decimal code to identify the error location 
and type. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E70048 


Explanation: An internal inconsistency has been detected by 
the SORT subcomponent. 


a Internal DB2 Information —~_ <= ~— 


This abend reason code is issued by the following CSECT(s): 
DSNXSORI 


—_———s End of Internal DB2 Information Seen 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. The application program abends. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. Provide a 
print of the SVC dump to the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Determine the failing environment (DB2, IMS/VS, CICS, or TSO). 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: Sort has detected an internal incon- 
sistency. The precise problem can be determined only by ana- 
lyzing the abending module at the point of failure. The register 
contents at time of abend are set as follows: 


¢ R2 points to the SPL. 
e R@ is a unique decimal! code to identify the error location. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E70058 


Explanation: An internal inconsistency has been detected by 
the SORT subcomponent. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNXSMR DSNXSMRG 


[bests es ead End of Internal DB2 Information eee 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. The application program abends. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. Provide a 
print of the SVC dump to the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Determine the failing environment (DB2, IMS/VS, CICS, or TSO). 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The SORT subcomponent detected 
that the number of unsorted records input to SORT did not 
equal the number of sorted records returned by SORT minus 
the number of records removed from the sort by the evaluation 
of column functions. The precise probiem can be determined 
only by analyzing the abending module at the point of failure. 
The register contents at time of abend are set as follows: 


* R2 points to the SRTCOMM. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E70068 


Explanation: An internal inconsistency has been detected by 
the SORT subcomponent. 


internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNXSMR DSNXSMRG 


ar. End of Internal DB2 Information pon ceene | 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. The application program abends. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. Provide a 
print of the SVC dump to the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Determine the failing environment (DB2, IMS/VS, CICS, or TSO). 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The SORT subcomponent has 
detected a storage inconsistency in the merge process. The 
precise problem can be determined only by analyzing the 
abending module at the point of failure. The register contents 
at time of abend are set as follows: 


* R2 points to the SRTCOMM. 


Collect the following diagnostic items fisted in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E70068 — 00E70088 


00E70078 


Explanation: An internal inconsistency has been detected by 
the SORT subcomponent. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNXSMR DSNXSMRG 


et eee End of Internal DB2 Information estas ten 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. Provide a 
print of the SVC dump to the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Determine the failing environment (DB2, IMS/VS, CICS, or TSO). 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The SORT subcomponent has 
detected a sort workfile management inconsistency in the 
merge process. The precise problem can be determined only 
by analyzing the abending module at the point of failure. The 
register contents at time of abend are set as follows: 


*® R2 points to the SRTCOMM. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E70088 


Explanation: An internal inconsistency has been detected by 
the SORT subcomponent. 


| ” Internal DB2 Information ; : | 


This abend reason code is issued by the following CSECT(s): 


DSNXSORI DSNXSWFM DSNXSIN 
DSNXSMR DSNXSMRG 


a, End of Internal DB2 Information ee 6 2 Sze eal 


System Action: A record is written to SYS1.LOGREC and an 
SVC dump is requested. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. Provide a 
print of the SVC dump to the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Determine the failing environment (DB2, IMS/VS, CICS, or TSO). 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The SORT subcomponent has 
detected an error from the Data Manager. The register con- 
tents at the time of the abend are set as follows: 


¢ R2 points to the SRTCOMM. 


¢ R3 is a unique decimal code to identify the error location 
and type of Data Manager request that failed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


DB2 Codes 4-229 








00E70098 — 00E70913 


00E70098 


Explanation: The SORT subcomponent detected an internal 
inconsistency. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNXSORI 


Remeereaeas End of Internal DB2 Information gestion as 4 


System Action: DB2 writes a SYS1.LOGREC record and 
requests an SVC dump. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. Give a 
printout of the SVC dump to the system programmer. 


System Programmer Response: This is a DB2 internal error. 
Determine the failing environment (DB2, IMS/VS, CICS, or TSO). 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The SORT subcomponent detected an 
invalid request for tag sort processing. The register contents at 
the time of the abend are set as follows: 


* R2 points to the SRTCOMM. 
¢ R3 is a unique decimal! code identifying the error location. 


Collect the following diagnostic items listen in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E7009E 


Explanation: Object depends on new facilities of the release 
from which fall back has occurred. 


| Internal DB2 Information aa aia 


This abend reason code is issued by the following CSECT(s): 


DSNXIAIX DSNXIATB DSNXIATS 
DSNXICIX DSNXICTB DSNXIDIX 

DSNXIDTB DSNXIDTS DSNXOCA 
DSNXOLV 


en eres End of Internal DB2 Information Pome ere ll 


System Action: The operation is not allowed. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: !n order to perform the opera- 
tion on the object, re-migration is required. 


Problem Determination: The requested operation is not per- 
formed. An SQL return code of -904 and/or message DSNTS501I 
is issued. Message DSNT501! describes which object has the 
release dependency. 


00E7009F 


Explanation: An error occurred while loading the catalog DBD 
during start-up processing. 


4-230 DB2 Messages and Codes 


| : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNXLDBD 


[shoe tet End of Internal DB2 Information $22 a et 


System Action: The current -START command processing is 
terminated. 


Operator Response: Retry the DB2 -START command. If the 
failure persists, notify the system programmer. 


System Programmer Response: Obtain a print of 
SYS1.LOGREC and the SVC dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Register 2 points to a character string 
which describes the specific error encountered. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00E70911 


Explanation: The current unit of work was the victim in a dead- 
lock, or experienced a timeout, and was rolled back. 


The reason code indicates whether a deadlock or timeout 
occurred. Refer to message DSNT500! under “Service Con- 
troller and Installation Messages (DSNT...)” on page 3-121 for 
an explanation of resource type and resource name. 


Note: The changes associated with the unit of work must be 
entered again. 


i. interna! DB2 Information a | 


This abend reason code is issued by the following CSECT(s): 
DSNCEXT3, DSNMDR10 


eee eee End of Internal DB2 Information Fees sl 


System Action: The statement cannot be executed. The appli- 
cation is rolled back to the previous COMMIT. 


Programmer Response: A long-running application, or an 
application that is likely to encounter a deadlock, should (if pos- 
sible) issue frequent COMMIT commands. This can lessen the 
possibility of a deadlock occurring. On receipt of the 00E70911 
abend reason code, the application should, in general, termi- 
nate. 


00E70913 


Explanation: The application was the victim in a deadlock or 
experienced a timeout. 


The reason code indicates whether a deadlock or timeout 
occurred. Refer to message DSNT500! under “Service Con- 
troller and Installation Messages (DSNT...)” on page 3-121 for 
an explanation of the resource type and resource name. 


‘Tied ~ Internal DB2 Information ~~~ ima | 


This abend reason code is issued by the following CSECT(s):. 
DSNXEEZ 


eee End of Internal DB2 Information ee ee 


System Action: The statement cannot be executed. Programmer Response: The application should either commit 
or roll back to the previous COMMIT. Then, in general, the 
application should terminate. 


DB2 Codes 4-231 





Initialization 


Procedures Codes (X'E8') 


00E80001 


Explanation: A required parameter was not passed via the 
MVS MGCR service which started the DB2 address space. The 
parameter must be the address of SCOM for the system ser- 
vices address space or the address on an ASCE for the data- 
base services address space or the distributed data facility 
address space. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


We eet End of Internal DB2 Information a ee! 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the parameter value in error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5, 8. 


00E80002 


Explanation: The DB2 subsystem services address space was 
not started by a valid subsystem or an error occurred during 
MVS IEFSSREQ processing. 


| internal DB2 Information - 5 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


fetes End of Internal DB2 Information ae eee 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of an 
8-byte field that contains the following diagnostic information: 


00E80001 — 00E80004 


bytes 1 through 4, the subsystem name; bytes 5 through 8, the 
contents of register 15 that contains the return code set by the 
MVS IEFSSREQ macro. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5, 8. 


00E80003 


Explanation: An unsupported pending function request was 
detected during processing in the system services address 
space. 


internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


eee End of Internal DB2 Information ee ry 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the pending function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80004 


Explanation: An error occurred when a POST was issued from 
a resource manager address space to the system services 
address space in order to indicate that the DB2 subsystem 
startup function completed successfully. 


| Internal DB2 Information eyo ; 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


eer rere End of internal DB2 Information Pete ee | 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: The system services address space 
might be abnormally terminating. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


DB2 Codes 4-233 


00E80005 — 00E80011 


00E80005 


Explanation: An error occurred when a POST was issued from 
a resource manager address space to the system services 
address space in order to indicate that the allied authorization 
function completed successfully. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


[| End of Internal DB2 Information ____———_| 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Probable cause is that the system ser- 
vices address space is abnormally terminating. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OOE80006 


Explanation: An unsupported pending function request was 
detected during processing in the resource manager address 
Space. 


[~ — Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


(ee oe End of Internal DB2 Information ee eee 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the pending function request value. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OQOES000E 


Explanation: MVS was unable to establish an ESTAE for the 
DB2 address space control task. 


Internal DB2 Information ms i 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


Wetec End of Internal DB2 Information Seen ae 


4-234 DB2 Messages and Codes 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the ESTAE macro return code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OOES8000F 


Explanation: The expected latent parameter passed by the 
MVS MGCR macro service is invalid. The cause was probably 
an attempt to start DB2 by some means other than the 
command -START DB2. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP 


Ls Eneof internal DB2 Information | 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Probiem Determination: Register 9 contains the address of a 
4-byte field that contains the parameter value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5, 8. 


00E80011 


Explanation: MVS was unable to make the address space non- 
swappable. 


| ” “—~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYASTR 


| snd of Internal DB2 Information ____———_— 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code © 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5, 8. 


00E80012 


Explanation: An error occurred when a POST was issued from 
the system services address space to a resource manager 
address space in order to indicate the results of the MGCR 
invocation. 


| Internal DB2 Information a 


This abend reason code is issued by the following CSECT(s): 
DSNYASTR 


[te eee End of Internal DB2 Information ee 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: The resource manager address space 
might be abnormally terminating. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5, 8. 


00E80013 


Explanation: MVS was unable to create a resource manager 
address space. 


[Roe re en ~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYASTR 


oe eeeere End of Internal DB2 Information eee) 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of an 
8-byte field that contains the following diagnostic information: 
bytes 1 through 4, the four character resource manager 
address space name; bytes 5 through 8, and the MGCR return 
code. 


Probable cause is that the MVS auxiliary storage management 
has inhibited the starting of new address spaces because of a 
shortage of real storage. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80012 — 00E80031 


OOE8001F 


Explanation: An unsupported function request was detected by 
the DB2 address space start function. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYASTR 


[it eteetees End of Internal DB2 Information est 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E8002F 


Explanation: An unsupported function request was detected by 
the DB2 address space stop function. 


[ ~~ internal DB2 Information ~ ” — ] 


This abend reason code is issued by the following CSECT(s): 
DSNYASTP 


fi asap ene End of Internal DB2 Information ae 


System Action: The DB2 subsystem is terminated. : 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 


' nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80031 


Explanation: An unsupported input parameter was detected for 
allied address space initialization. 


Internal DB2 information 


This abend reason code is issued by the following CSECT(s): 
DSNYALLI 


| earners: End of Internal DB2 Information See 


DB2 Codes 4-235 


00E80032 — O0E8003E 


System Action: The caller’s task is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the parameter value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80032 


Explanation: An unsupported input parameter was detected for 
allied address space termination. 


| Internal DB2 Information 7 pees 


This abend reason code is issued by the following CSECT(s): 
DSNYALLI 


{Ss End of Internal DB2 Information ____—_| 


System Action: The caller’s task is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Probiem Determination: Register 9 contains the address of a 
4-byte field that contains the parameter value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80033 


Explanation: This reason code accompanies a X'04F' system 
abend code. This module detected that the DB2 subsystem was 
terminating. Refer to “DB2 Abend Completion Codes (X'04E' 
and X'04F)” on page 1-6. 


[— ~~ _ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYALLI 


ee End of Internal DB2 Information Fie ost 


System Action: The caller’s task is abended with code X'04F' 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


4-236 DB2 Messages and Codes 


00E8003C 


Explanation: An address space control element (ASCE) could 
not be located for the executing address space during EOM 
processing. 


| Internal DB2 Information <5 7 


This abend reason code is issued by the following CSECT(s): 
DSNYALLI 


ieee, End of Internal DB2 Information eae, 


System Action: The caller’s task is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Coilect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


00E8003D 


Explanation: An unrecovered resource (for example, a latch) 
was deiected for a must-complete function. 


—S a: — Internal DB2 Information pe | 


This abend reason code is issued by the following CSECT(s): 
DSNYALLI 


a End of internal DB2 Information re 


System Action: Abnormal termination of the DB2 subsystem is 
initiated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'O4F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


O0E8003E 


Explanation: MVS was unable to establish an ESTAE in an 
address space about to be initialized as a DB2 allied address 
space. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYALLI 


er ce End of Internal DB2 Information ———— 


System Action: The caller’s task is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Probiem Determination: Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'O4F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OQOE8003F 


Explanation: An unsupported function request was detected by 
the allied address space control function. 


i oe ~ Internal DB2 Information ~~ — Tia Omar | 


This abend reason code is issued by the following CSECT(s): 
DSNYALLI 


[Bece toa hese End of Internal DB2 Information a ad 


System Action: The caller’s task is abnormally terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80041 


Explanation: An error occurred when a POST was issued from 
an allied address space to the system services address space 
in order to indicate a pending allied authorization request. 


tay 2 Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSNYAUTH 


Ls End of internal DB2 Information 


System Action: The DB2 subsystem is terminated. 


OOE8003F — O0E8004F 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: The system services address space 
might be abnormally terminating. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80042 


Explanation: An error occurred when a POST was issued from 
the system services address space to a resource manager 
address space in order to indicate a pending allied authori- 
zation request. 


[ ee Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYAUTH 


[fede aeaaeee End of Interna! DB2 Information ey | 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: The resource manager address space 
might be abnormally terminating. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E8004F 


Explanation: An unsupported function request was detected by 
the allied address space authorization function. 


‘a ~~ internal DB2 Information ~~ “| 


This abend reason code is issued by the following CSECT(s): 
DSNYAUTH 


[ee ee, End of Internal DB2 Information Fake | 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


DB2 Codes 4-237 


00E80051 — 00E80054 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80051 


Explanation: An error was detected in the command that was 
used to start the DB2 subsystem. There are two conditions that 
can cause this error. If the -START DB2 command is in error, 
this abend results. 


Secondly, if the DB2 subsystem is not running (had never been 
started, or had been stopped), any DB2 command that is 
entered is interpreted as being a -START DB2 command. In this 
second case, the subsystem starts just long enough to discover 
that the command actually is not a -START DB2 command and 
then issues the abend. 


[ro — Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRT 


[ee ae ees End of internal DB2 Information oe ee | 


System Action: The DB2 subsystem is terminated. 


Operator Response: Reenter the command if it was entered in 
error; otherwise advise the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


This error does not cause a SYS1.LOGREC record to be written 
or an SVC dump to be requested. A diagnostic too] (for 
example, MVS SLIP) is required to get subcomponent diag- 
nostic information. 


Problem Determination: Register 9 contains the address of a 
12-byte field that contains the following diagnostic information: 
bytes 1 through 4, the address of the buffer that contains the 
command used to start DB2; bytes 5 through 8, the general 
command processor return code; bytes 9 through 12, the IPC 
command processor return code, or 'FFFFFFFF' if bytes 5 
through 8 contain a positive value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80052 


Explanation: A resource manager provided notification of 
failure during facility startup notification processing. 


t age ee Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRT 


es End of Internal DB2 Information P| 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


4-238 DB2 Messages and Codes 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address ofa 
4-byte field that contains the RMID of the resource manager that 
requested DB2 subsystem termination. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80053 


Explanation: A resource manager provided notification of 
failure during release work notification processing. 


| internal DB2 Information ~~ eas 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRT 


| End of Internal DB2 Information 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the RMID of the resource manager that 
requested DB2 subsystem termination. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80054 


Explanation: The recovery manager (RM) subcomponent pro- 
vided notification of an error during restart recovery proc- 
essing. 


| Internal DB2 Information —" | 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRT 


[a End of Interna! DB2 Information ETE 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the return code from the recovery 
manager subcomponent. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 





0OE80055 


Explanation: The recovery manager (RM) subcomponent 
detected an error during DB2 checkpoint processing. 


i ~~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRT 


ae re: End of Internal DB2 Information Sr 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the return code from the recovery 
manager subcomponent. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80056 


Explanation: During startup, DB2 was unable to access 
DSN6FAC in ZPARMS and therefore was unable to determine 
whether the distributed data facility was to be loaded. 


| Internal DB2 Information — | 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRT 


gene tere End of Internal DB2 information eee | 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Assemble DSN6FAC and re- 
link-edit the DSNZPARM load module. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9. 


OOESO0SF 


Explanation: An unsupported function request was detected by 
the DB2 subsystem startup control function. 


| 7 Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRT 


eee ee End of Internal DB2 Information ieee eh 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer. 


00E80055 — 00E8006F 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80061 


Explanation: A resource manager initialization table (RMIT) 
that has an invalid format was detected. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYSDLB 


Eee eee End of Internal DB2 information Fat Se 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of an 
8-byte field that contains the name of the load module in which 
the invalid resource manager initialization table (RMIT) format 
exists. 


Probable cause is that the load module does not contain an 
RMIT or, the linkage editor entry control statement does not 
specify the RMIT as the module entry point. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OOE8006F 


Explanation: An unsupported function request was detected by 
the definitional control block management function. 


| — == Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYSDLB 


Sa es End of Internal DB2 information eater 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


DB2 Codes 4-239 


00E8007F — 00E80091 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E8007F 


Explanation: An unsupported function request was detected by 
the application program call parameter management function. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYSPCB 


se ee End of Internal DB2 Information a eee, 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80081 


Explanation: An invalid initialization load module list (ILML) 
was detected. 


ail Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYSIRM 


a’ End of Internal DB2 Information Settee 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: The module might not contain an 
initialization load module list or the linkage editor entry control 
statement might not specify the initialization load module list as 
the module entry point. 


Register 9 contains the address of an 8-byte field that contains 
the name of the module that holds the invalid initialization load 
module list. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


4-240 DB2 Messages and Codes 


00E80084 


Explanation: A resource manager provided notification of 
failure during subsystem startup notification processing. 


ea Internal DB2 Information = 


This abend reason code is issued by the following CSECT(s): 
DSNYSIRM 


{ End of Internal DB2 Information as 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the RMID of the resource manager that 
requested DB2 subsystem termination. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5, 8, 9, 15, 18. 


OOE8008F 


Explanation: An unsupported function request was detected by 
the resource manager initialization function. 


ene ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYSIRM 


[i ete End of Internal DB2 Information Pes) 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80091 


Explanation: An error occurred when a POST was issued from 
the control address space to a resource manager address 
space in order to indicate that DB2 shutdown is to be initiated 
for that address space. 


| Internal DB2 Information i 


This abend reason code is issued by the following CSECT(s): 
DSNYSTOP 


aa ee End of internal DB2 Information ee | 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: The resource manager address space 
might be abnormally terminating. 


‘Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OOE8009F 


Explanation: An unsupported function request was detected by 
the DB2 subsystem shutdown control function. 


[~ mS ~ {Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYSTOP 


[eee eae End of Internal DB2 Information eee fae 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Probiem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OOES00AF 


Explanation: An unsupported function request was detected by 
the resource manager termination function. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYSTRM 


fee eee End of Internal DB2 Information Bogie eel 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


OOE8009F — O0E800CE 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte fieid that contains the function request value. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E800B1 


Explanation: A service task could not be created during proc- 
essing of the -STOP DB2 command. 


| ——— Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNYSCMD 


Renee sah tees End of Interna! DB2 Information Soa sates ee seal 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the return code from the create- 
service task function of the agent services manager (ASM) sub- 
component. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


OOES00CE 


Explanation: MVS was unable to establish an ESTAE for the 
stop-work notification function. 


| Internal DB2 Information ~ SH 


This abend reason code is issued by the following CSECT(s): 
DSNYSTPW 


Aes et ee SS End of Internal DB2 Information ee 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address ofa 
4-byte field that contains the ESTAE macro return code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


DB2 Codes 4-241 


00E800D1 — 00E80100 


00E800D1 


Explanation: A resource manager provided notification of 
failure during local memory-create notification processing. 


Internal DB2 Information == ] 


This abend reason code is issued by the following CSECT(s): 
DSNYAGCS 


ees End of Internal DB2 Information a Mes 2 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the RMID of the resource manager that 
requested DB2 subsystem termination. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E800D2 


Explanation: An error was encountered while attempting to 
obtain the MVS LOCAL lock. 


Internal DB2 Information ~ a 


This abend reason code is issued by the following CSECT(s): 
DSNYAGCS 


eee End of internal DB2 Information ees 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


00E800D3 


Explanation: An error was encountered while attempting to 
release the MVS LOCAL lock. 


[ a op a Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYAGCS 


eres End of internal DB2 Information eee 


4-242 DB2 Messages and Codes 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


O0E800DF 


Explanation: An unsupported function request was detected by 
the address space global common services function. 


Internal DB2 Information —_ sl 


This abend reason code is issued by the following CSECT(s): 
DSNYAGCS 


_——aa End of Internal DB2 Information id 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a print of 
SYS1.LOGREC and the SVC dump. Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures and 
for information about dump analysis and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80100 


Explanation: The DB2 subsystem was abnormally terminated 
because the DB2 address space control task ESTAE was 
entered. This reason code is issued for all abend completion 
codes, except for the X'04E' abend completion code. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYECTE 


re End of Internal DB2 Information eee 


System Action: Termination of the DB2 subsystem is initiated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 


.to Section 5 of Diagnosis Guide and Reference for more infor- 


mation on the VRA, dump analysis, and service aids. 


The DB2 subsystem is unable to determine the cause of the 
error. 


Problem Determination: The subcomponent that caused the 
error is unknown. Refer to “DB2 Abend Completion Codes 


(X'04E' and X'04F)” on page 1-6 for information on X'04F' and 
X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5, 9, 15, 18. 


00E8011D 


Explanation: An unrecovered resource (for example, a latch) 
was detected for a must-complete function. 


[ ~ internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYEATE 


(ee et, End of Internal DB2 information ae El 


System Action: Termination of DB2 subsystem is initiated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E8011E 


Explanation: The allied address space task primary ESTAE 
detected that MVS was unable to establish the secondary 
ESTAE. 


Internal DB2 Information : : | 


This abend reason code is issued by the following CSECT(s): 
DSNYEATE 


(eta eed End of Internal DB2 Information oath ee 


System Action: Abnormal termination of allied address space 
is continued. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


00E8011F 


Explanation: The allied address space task primary ESTAE 
was entered without a subsystem diagnostic work area (SDWA) 
provided by MVS RTM. 


00E8011D — 00E8012F 


| Internal DB2 information Toate “al 


This abend reason code is issued by the following CSECT(s): 
DSNYEATE 


fee End of internal DB2 !nformation Bee 


System Action: Abnormal termination of the allied address 
space is continued. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


00E8012D 


Explanation: The allied address space task secondary ESTAE 
detected an unrecovered resource (for example, a latch) for a 
‘must complete’ function. 


Le va Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYEAT2 


Was ey End of Internal DB2 Information ees 


System Action: Abnormal termination of DB2 subsystem is ini- 
tiated. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The. recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E8012F 


Explanation: The allied address space task secondary ESTAE 
was entered without a subsystem diagnostic work area (SDWA) 
provided by MVS. 


| Internal DB2 Information ~~ = 


This abend reason code is issued by the following CSECT(s): 
DSNYEAT2 


eae End of Internal DB2 Information ee eee 
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00E80130 — 00E80151 


System Action: Continue with the abnorma! termination of the 
allied address space. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
3, 5. 


00E80130 


Explanation: The FRR that protects the -START/-STOP DB2 
command processor function was entered while a valid -STOP 
DB2 command was being processed. 


[ . ~~ Internal DB2 Information aa sf 


This abend reason code is issued by the following CSECT(s): 
DSNYESCF 


nee End of Internal DB2 Information ee ae 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


Problem Determination: Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80140 


Explanation: The ESTAE that protects the stop work notifica- 
tion function was entered. 


| aa internal DB2 Information eet eye ay 


This abend reason code is issued by the following CSECT(s): 
DSNYESWE 


Lee End of Internal DB2 Information ee ted 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA. 


4-244 DB2 Messages and Codes 


Problem Determination: Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'O4F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80150 


Explanation: An initialization entry point fist having an invalid 
format was detected. 


| : ” Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNYEMCL 


en et End of internal DB2 Information ee 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Probiem Determination: Register 9 contains the address of an 
8-byte field that holds the name of the load module in which the 
invalid initialization entry point list exists. 


Probable cause is that the module does not contain an initial- 
ization entry point list or the linkage editor entry control state- 
ment does not specify the initialization entry point list as the 
module entry point. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80151 


Explanation: An invalid module entry point address was 
detected in an initialization entry point list entry. 


| interna! DB2 Information 4 ] 


This abend reason code is issued by the following CSECT(s): 
DSNYEMCL 


Wee ta an End of Internal DB2 Information Bee] 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Probiem Determination: Register 9 contains the address of a 
12-byte field that contains the following diagnostic information: 
bytes 1 through 8, the name of the load module that contains 
the initialization entry point list with the invalid entry; bytes 9 
through 12, and the entry number of the initialization entry point 
list entry. Probable cause is that the initialization entry point 


list entry defines an invalid module entry point or defines a 
valid entry point for a module that has not been included in the 
loaded module. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E8015F 


Explanation: An unsupported function request was detected by 
the module entry point list (MEPL) management function. 


[ as Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNYEMCL 


re End of Internal DB2 Information eee 


System Action: The DB2 subsystem is terminated. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


The recovery routine for the CSECT issuing this reason code 
records information in the variable recording area (VRA). Refer 
to Section 5 of Diagnosis Guide and Reference for more infor- 
mation on the VRA, dump analysis, and service aids. 


Problem Determination: Register 9 contains the address of a 
4-byte field that contains the function request value. 


Callect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 2, 3, 5. 


00E80160 


Explanation: During DB2 startup processing, the Initialization 
Procedures subcomponent detected a load module with an 
invalid AMODE or RMODE attribute. The abend is preceded by 
message DSNYO06i or by DSNYO071. 


OOE8015F — 00E80170 


Internal DB2 Information —— ay 


This abend reason code is issued by the following CSECT(s): 
DSNYASCP DSNYASTR, DSNYSTRT, DSYSIRM 


[pe a ae 2 End of internal DB2 tnformation elas alee S| 


System Action: Subsystem startup is terminated. 


Operator Response: See message DSNYOO6I or message 
DSNY0071. 


System Programmer Response: The recovery routine for the 
CSECT issuing this reason code records information in the vari- 
able recording area (VRA). Refer to Section 5 of Diagnosis 
Guide and Reference for more information on the VRA. 


See message DSNYOO6! or message DSNYO07I. 


Problem Determination: See message DSNYOO6I or message 
DSNYO0071. 


00E80170 


Explanation: You requested a facility that was not loaded or 
started at the time DB2 started. Whether or not to load or start 
a facility is contained in the DSN6FAC member in ZPARMS. 


This reason code. is returned to the calling CSECT(s) by 
DSNYNFAC along with a return code of 8. 


This is not an error in DSNYNFAC. If an error exists, it might be 
in the calling CSECT or in the DSN6FAC member in ZPARMS. 


System Action: This is determined by the caller of DSNYNFAC. 
Operator Response: Notify the system programmer. 


System Programmer Response: if it can be determined that 
DSN6FAC is in error, assemble DSN6FAC with corrections and 
re-link-edit the DSNZPARM load module. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5, 9. 
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a 


00E90101 — 00E90203 





System Parameter Manager Codes (X'E9') 


00E90101 


Explanation: This reason code is issued when a DB2 directory 
cannot be opened. This is probably a DB2 subsystem error. 


This abend reason code is issued by the module identified in 
the SYS1.LOGREC entry for this abend code. 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a print of 
SYS1.LOGREC and the SVC dump. 


Problem Determination: This abend results when any one of a 
number of DB2 internal directories cannot be opened. One 
customer-usable directory can also cause this abend if it cannot 
be opened. This is the DSNZPARM directory that is established 
at installation. 


This directory may have a name different from that specified at 
installation, because the customer has the option of changing 
the name during installation. Ensure that the DSNZPARM direc- 
tory (or its equivalent) is available to be opened. 


lf the DSNZPARM directory (or its equivalent) is available, the 
problem is a DB2 subsystem problem. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


This abend is intercepted by an FRR or ESTAE for the subcom- 
ponent or module that issued the DSNZOPEN request. The 
module containing the abended request is identified in the 
SYS1.LOGREC entry. This information may be useful in com- 
municating with IBM about the problem. 


Collect the following diagnostic items tisted in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 8, 9, 31. 


00E90201 


Explanation: An incorrect parameter was encountered. This 
reason code is issued by module DSNZTGET in response to a 
DSNZGDE request. This is a DB2 subsystem error. 


ie as Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNZTGET 


[st eee eta: End of Internal DB2 Information id 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a print of 
SYS1.LOGREC and the SVC dump. 


Problem Determination: Locate the caller's save area by 
examining register 13 in the SYS1.LOGREC register save area. 
Registers 0 and 1 in the caller’s save area identify the incorrect 
parameter(s). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 8, 9, 31. 


00E90202 


Explanation: An error was found in the directory control infor- 
mation for a DB2 directory. This is probably a DB2 subsystem 
error. 


Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNZTGET 


aes End of Internal DB2 Information ener 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requesied. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a print of 
SYS1.LOGREC and the SVC dump. 


Problem Determination: This abend results when incorrect 
control information is found for any one of a number of DB2 
internal directories. One customer-usable directory can also 
cause this abend. This is the DSNZPARM directory that is 
established during installation. 


This directory may have a name different from that specified at 
installation, because the customer has the option of changing 
the name during installation. Ensure that the DSNZPARM direc- 
tory (or its equivalent) is available. 


if the DSNZPARM directory (or its equivalent) is available, the 
problem is a DB2 subsystem problem. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


Coilect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 8, 9, 31. 


00E390203 


Explanation: An error was found in the descriptor control infor- 
mation for a DB2 directory. This is probably a DB2 subsystem 
error. 


i ——~ Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNZTGET 


ae End of Internal DB2 Information oat eel 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 


Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a print of 
SYS1.LOGREC and the SVC dump. 


Problem Determination: This abend results when the 
descriptor control information is incorrect for any one of a 
number of DB2 directories. One customer-usable directory can 
also cause this abend. This is the DSNZPARM directory that is 
established at installation. 


This directory may have a name different from that specified at 
installation, because the customer has the option of changing 


DB2 Codes 4-247 


00E90301 — 00E90301 


the name during installation. Ensure that the DSNZPARM direc- 
tory (or its equivalent) is available. 


If the DSNZPARM directory (or its equivalent) is available, the 
problem is a DB2 subsystem problem. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 8, 9, 31. 


00E90301 


Explanation: This reason code is issued when a DB2 directory 
cannot be closed. This is probably a DB2 subsystem error. 


Internal DB2 Information | 


This abend reason code is issued by the module identified in 
the SYS1.LOGREC entry for this abend code. 


Woe aE aeAt ate End of Internal DB2 Information ee teed 


System Action: A record is written to SYS1.LOGREC, and an 
SVC dump is requested. 
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Operator Response: Notify the system programmer. 


System Programmer Response: Obtain a print of 
SYS1.LOGREC and the SVC dump. 


Problem Determination: This abend results when any one of a 
number of DB2 internal directories cannot be closed. One 
customer-usable directory can also cause this abend if it cannot 
be closed. This is the DSNZPARM directory that is established 
at installation. 


This directory may have a name different from that specified at 
installation, because the customer has the option of changing 
the name during installation. Ensure that the DSNZPARM direc- 
tory (or its equivalent) is available to be opened. 


If the DSNZPARM directory (or its equivalent) is available, the 
problem is a DB2 subsystem problem. Refer to Section 5 of 
Diagnosis Guide and Reference for failure analysis procedures. 


This abend is intercepted by an FRR or ESTAE for the subcom- 
ponent or module that issued the DSNZOPEN request. The 
module containing the abended request is identified in the 
SYS1.LOGREC entry. This information may be useful in com- 
municating with IBM about the problem. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 3, 5, 8, 9, 31. 





Service Facilities Codes (X'F1') 


The DSN1ILOGP service aid can abnormally terminate with a 
user abend code of X'099'. You can find the corresponding 
abend reason code in register 15 at the time of error. 


00F10100 


Explanation: An internal error has been detected in the 
DSN1LOGP service aid. 


Operator Response: Refer to Section 5 of Diagnosis Guide and 
Reference and contact the IBM support center. 


00F10100 — 00F10101 


00F 10101 


Explanation: The stand-alone log read function returned an 
invalid RBA. See the explanation for message DSN1211E. 


Operator Response: !f you determine that the data set is a log 
data set and that it is not damaged, refer to Section 5 of Diag- 
nosis Guide and Reference and contact the IBM support center. 
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Subsystem 


Support Subcomponent Codes (X'F3') 


Many of the following abend reason codes are returned in reg- 
ister 15 at the time of an X'0Cx' system abend and not as the 
reason code for an X'04E' abend. This is indicated in the 
descriptions that follow. 


00F30001 


Explanation: This reason code may be returned to subsystem- 
type recovery coordinators when they connect to DB2 or during 
processing of indoubt threads to inform the coordinator that 
further recovery coordination actions are required. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


[ =} : ~~ Internal DB2 Information ~~ —————— | 


This DB2 reason code is issued by the following CSECT(s): 
DSN31D30, DSN3RIAO, DSN3RISO 


ae End of Internal DB2 Information _ 


System Action: Processing continues. 


00F30002 


Explanation: The requested DB2 subsystem, as specified by 
the subsystem name, is not active. The option to notify the 
requestor, either via an ECB post or a SEND/MODIFY MVS 
command, is accepted. 


a ~~ Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3CLO00, DSN3SCLOX 


Poste Seep a) End of Internal DB2 Information cones | 


System Action: The request to notify the caller when the sub- 
system is active is queued for processing during subsystem 
startup. 


User Response: Retry the connection request after DB2 has 
been started. 


00F30003 


Explanation: An abend has occurred during an attempt to 
access or modify the caller-provided function request block 
(FRB) while executing in the caller’s PSW key. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNAPRH DSNAPRHO DSNAPRHX 
DSN3CLO0 DSN3CLOX DSN3ID00 
DSN3iD30 


Di Ses eee End of internal DB2 Information eae 


00F30001 — 00F30005 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: This reason code is placed in register 
15 during any access to an attachment-provided function 
request block (FRB). A subsequent X'0Cx' abend indicates an 
FRB addressability problem. This abend is probably the result 
of a logic error in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30004 


Explanation: An abend has occurred during an attempt to 
access the attachment-provided parameter list while executing 
in the caller’s PSW key. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 


DSNAPRH DSNAPRHO DSNAPRHX 
DSN3CLO00 DSN3CLOX DSN3CT30 
DSN3CT80 DSN3EXTO DSN3IDOO 
DSN3ID30 DSN3ID80 DSN3PROO 
DSN3RIAO DSNB3SI30 DSN3SI80 
DSN3TROO 


Lo End of Internal DB2 information ae es 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: This reason code is placed in register 
15 during any access to an attachment-provided parameter list. 
A subsequent X'0Cx' abend indicates a parameter address- 
ability problem. 


This abend is probably the result of a logic error in the attach- 
ment facility. For call attachment users, the abend may have 
been caused by a bad parameter address passed to call attach- 
ment. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30005 


Explanation: An error was detected during processing of a 
request to establish or delete a ‘termination ECB'. Eithera 
parameter value was incorrect or an abend occurred while 
accessing the the attachment-provided parameter list. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3EXTO 


Pete ke End of Internal DB2 Information oat 


System Action: The request is not processed. 
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00F30006 — 00F30010 


User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: For the non-abend case, either the 
ECB address was zero or the Request Code was not 
'Establish' or 'Delete'. If the reason code is in register 15 on 
an abend, either the parameter list or a parameter value was 
not addressable in the calier’s PSW key. 


The error may be the result of an internal error in the attach- 
ment facility. Call attachment users should check that the sup- 
plied ECB address is not zero and that it is addressable in their 
PSW key. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


OOF 30006 


Explanation: A failure occurred while processing the 
‘Subsystem Name' during connection processing. In the 
abend case, connection processing failed when accessing the 
‘Subsystem Name’ in the caller’s PSW key. In the non-abend 
case, MVS was unable to locate a DB2 subsystem with the 
specified name. 


[ paren Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSN3IDOO 


er ee End of Internal DB2 Information eee eras 


System Action: The request is not processed. 


User Response: A dump should be taken in your recovery 
routine for abend analysis. If the named subsystem could not 
be found, verify that the correct subsystem name was specified. 
Call attachment users should note that the Translate function 
CANNOT be invoked for this reason code. 


System Programmer Response: See Problem Determination. 


Problem Determination: If the named subsystem could not be 
found, scan the MVS system log to verify that it was initialized 
during MVS IPL processing. 


If this reason code was specified in register 15 on an abend, 
check that the subsystem name value is addressable in the 
caller’s PSW key. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 48. 


00F30007 


Explanation: A failure occurred while processing the 
‘Connection Type' parameter during connection processing. 
Either the 'Connection Type' value was invalid or an abend 
occurred accessing the parameter using the caller’s PSW key. 


[ _  nternal DB2 Information oe —— | 


This reason code is issued by the following CSECT(s): 
DSN3CLO00, DSNSCLOX, DSN3ID30 


[_seEnd of Internal DB2 Information _____—_| 


System Action: The request is not processed. 


User Response: A dump should be taken for problem analysis. 
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System Programmer Response: See Problem Determination. 


Problem Determination: For the abend case, this reason code 
is placed in register 15 to identify which parameter was not 
addressable in the caller’s PSW key. This failure is probably 
the result of a logic error in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30008 


Explanation: A failure occurred while processing the ' Notify 
Message/Startup ECB' parameter during connection proc- 
essing. An abend occurs while accessing the parameter or 
while verifying that the ECB word was addressable in the 
caller’s PSW key. In the non-abend case, either the parameter 
had a zero length or the supplied ECB address was zero. 


| internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3CLO00, DSN3CLOX 


| End of internal DB2 Information ____——_—| 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: For the abend case, this reason code 
is placed in register 15 to identify which parameter was not 
addressable in the caller’s PSW key. The failure may be due to 
a logic error in the attachment facility. Call Attachment users 
should verify that the Startup ECB address is non-zero and that 
the ECB word is addressable in their PSW key. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30009 


Explanation: A request was received to establish a termination 
ECB, but a termination ECB had already been established for 
the connected task. 


[Ss 7 ~ Internal DB2 Information ~ 


This reason code is issued by the following CSECT(s): 
DSN3EXTO 


es End of !nternal DB2 Information | 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain ali dumps taken by the 
attachment facility or invoking application. 


Problem Determination: This failure is probably the result of a 
logic error in the attachment facility. 


00F30010 


Explanation: A request was received to delete a termination 
ECB, but a termination ECB has not been established for the 
connected task. 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3EXTO 


res End of Internal DB2 Information ee ere 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility or invoking application. 


Problem Determination: This failure is probably the result of a 
logic error in the attachment facility. 


00F30011 


Explanation: A connection or other work request was received, 
but the designated DB2 subsystem is not active. If the request 
was to connect to the subsystem, and the Notify 
Message/Startup ECB was supplied, it was not accepted. 


—_ — {nternal DB2 Information ~ =| 


This reason code is issued by the following CSECT(s): 
DSNACLO0, DSN3CLOX, DSNAPRHO, DSNAPRHX 


re End of internal DB2 Information _ 


System Action: The request is not processed. 


User Response: If the failure occurred on a connection request 
and a Notify Message/Startup ECB was provided, a dump 
should be taken for problem analysis. Reconnect to DB2 when 
the subsystem is active again. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility or invoking application. 


Problem Determination: The Notify Message or Startup ECB 
could not be accepted for one of two reasons. 


e Storage for a buffer could not be obtained, or 
¢ the length of the Message/ECB parameter was zero. 


In the latter case, the attachment facility is probably in error. If 
insufficient storage was available for a buffer, the size of the 
CSA in 24-bit storage should be increased. 


00F30012 


Explanation: The requested DB2 subsystem, as specified by 
the subsystem name, is not active. The option to notify the 
requestor, either via an ECB post or a SEND/MODIFY MVS 
command, is accepted, but overiays a previous Notify 
Message/Startup ECB request. 


[ internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3CLO0, DSN3CLOX 


er End of Internal DB2 Information fae ess! 


00F30011 — 00F30014 


System Action: The request to notify the caller when the sub- 
system is active is queued for processing during subsystem 
startup. 


User Response: Retry the connection request after DB2 has 
been started. 


00F30013 


Explanation: The requestor is not authorized to connect to this 
DB2 subsystem. This condition might indicate an attempted 
security violation. 


Internal DB2 Information ~ ates 


This reason code is issued by the following CSECT(s): 
DSN3ID30 


eee tee oe End of Internal DB2 Information oie et sh 


System Action: The connection request is denied. 


User Response: Verify that you have specified the correct 
RACF authorization ID. If necessary, request authorization to 
access the DB2 subsystem from your security administrator. 


System Programmer Response: Examine the console/SYSLOG 
output for RACF messages issued when a request is denied. 
Refer the user to your security administrator if the user should 
be granted authorization to a DB2 subsystem. Refer to Section 
5 (Volume 2) of Administration Guide examples of how to 
authorize users to specific DB2 subsystems. 


Problem Determination: During TCB connection processing, 
Subsystem Support invokes the RACROUTE service (causing a 
RACF RACHECK) to verify the authorization ID associated with 
the requestor. If the RACF return code indicates the requestor 
is not authorized to connect to this DB2 subsystem, the con- 
nection request is terminated with this reason code. 


00F30014 


Explanation: The requester of a Subsystem Support function 
(for example, ABORT) for a connection is not in the same PSW 
key as when the connection was created. 


Internal DB2 Information ~~ ea ie | 


This abend reason code is issued by the following CSECT(s): 
DSN3AB00, DSN3CM00, DSN3CT80, DSN3PRO0, DSN3SI30, 
DSN3SY00 


eee ee End of Internal DB2 Information arenes 


System Action: The requester’s task is abended with code 
X'04E'. 


User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: This failure may be the result of a 
logic error in the attachment facility or an intentional attempt to 
violate DB2 connection protocols. The error should be evaiu- 
ated in the same way as a system X'0C2' abend, an attempt by 
a nonprivileged program to perform privileged operations. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5, 48. 


DB2 Codes 4-253 


00F30015 — 00F30019 


00F30015 


Explanation: The attachment facility specified an invalid com- 
bination of values of FRBRALE and FRBQUAL. No Program 
Request Handler exists to service the call. 


[ og Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


ere End of Internal DB2 Information ee ae 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility and requesting application. 


Problem Determination: Register 1 contains a pointer to the 
FRB at the entry to DSNAPRHO or DSNAPRHX. The FRBRALE 
and FRBQUAL values in the caller’s FRB should be examined to 
determine which one is in error. Not all combinations of valid 
FRBRALE and FRBQUAL values are supported. Each RALE is 
supported differently. 


00F30016 


Explanation: The attachment facility specified an invalid 
FRBRALE value. The value is outside the limits of those sup- 
ported for the requesting connection. This can occur in many 
cases, one of which is when an SQL call is requested with a 
blank plan name by the requestor. 


| Internal DB2 Information = “| 


This reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


Peer sete End of Internal DB2 Information Pee) 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility and requesting application. 


Problem Determination: Register 1 contains a pointer to the 
FRB at the entry to DSNAPRHO or DSNAPRHX. FRBRALE con- 
tains the invalid value that was passed. The value passed is 
not consistent with the resources allocated to the connected 
application. 


If the plan name contains blanks, an SQL call is invalid. The 
requestor should respecify the plan name and issue the request 
again. 


00F30017 


Explanation: The attachment facility specified an invalid 
FRBQUAL value. The vaiue is outside the limits of those sup- 
ported for the requesting connection. 


4-254 DB2 Messages and Codes 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


Se aeereere ee End of Internal DB2 Information fo eh eel 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility and requesting application. 


Problem Determination: Register 1 contains a pointer to the 
FRB at the entry to DSNAPRHO or DSNAPRHX. FRBQUAL con- 
tains the invalid value that was passed. The value passed is 
not consistent with the resources allocated to the connected 
application. 


00F30018 


Explanation: The requester’s TCB is not connected to this 
instance of the DB2 subsystem. The TCB may have been con- 
nected to a previous instance. 


| Internal DB2 Information ~ | 


This reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


Pe eter End of Internal DB2 Information ee eee oll 


System Action: The request is not processed. 
User Response: You should request a new connection to DB2. 
System Programmer Response: See Problem Determination. 


Problem Determination: This error could occur if the DB2 sub- 
system had terminated and the connected application had 
issued a DB2 work request without re-establishing the con- 
nection after the subsystem was restarted. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 48. 


00F30019 


Explanation: The requester’s primary ASID (PASID) is not 
equal to the home ASID (PSAAOLD). 


Internal DB2 Information = ] 


This reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


(pee, End of Internal DB2 Information eee 


System Action: The request is not processed. 


User Response: You may want to take a dump for problem 
analysis. The request may be retried, but first ensure the CPU 
is not in cross-memory mode. 


System Programmer Response: See Problem Determination. 


Problem Determination: No requester of a DB2 attachment 
facility may be in cross-memory mode. That is, PASID must 
equal HASID, which must equal SASID. 


Collect the foliowing diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 48. 


00F30020 


Explanation: An error was detected while processing the 
‘Commit Option' on a SSAM termination request. Either the 
value of the 'Commit Option’ parameter was not valid or an 
abend occurred when accessing the parameter. 


| ; —— Internal DB2 Information ~ ee 


This abend reason code is issued by the following CSECT(s): 
DSN3ID80, DSN3SI80, DSN3TROO 


a End of Internal DB2 Information | 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: For the abend case, this reason code 
is placed in register 15 to identify which parameter was not 
addressable in the caller’s PSW key. The failure may be the 
result of a logic error in the attachment facility. Call Attachment 
users should note that only 'SYNC' and 'ABRT'. are valid ter- 
minate options. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30021 


Expianation: An attachment facility issued a Subsystem 
Support request, but provided too few or too many parameters. 


| internal DB2 Information a 


This abend reason code is issued by the following CSECT(s): 


DSN3AB00 DSN3CMO00 DSN3CT30 
DSN3CT80 DSNSEXTO DSN3ID30 

DSN3ID80 DSN3PRO0 DSN3RIAO 
DSN3SI30 DSN3SI80 DSN3SY00 


ie sets End of Internal DB2 Information oe eo | 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility or by the requesting application. 


Problem Determination: This failure is probably the result of a 
logic error in the attachment facility. 


Upon entry to each of the CSECTs listed above, register 1 con- 
tains the address of the Function Request Block (FRB). 
FRBPCNT contains the number of passed parameters and 
FRBPARM points to a list of parameter addresses. The 
required number of parameters is unique to the calling protocol 
for each CSECT. 


00F30020 — 00F30024 


00F30022 


Explanation: An error was detected while processing the 
‘Connection Name' for a connection request. Either the value 
of the 'Connection Name' parameter was not valid or an abend 
occurred when accessing the parameter. 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3ID30 


ss End of Internal DB2 Information eae, 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: For the abend case, this reason code 
is placed in register 15 to identify which parameter was not 
addressable in the caller’s PSW key. A 'Connection Name' is 
invalid if it is not a printable string (e.g. binary zeros). The 
failure is probably the result of a logic error in the attachment 
facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30023 


Explanation: This reason code may be returned during con- 
nection processing if the connection name is already in use by 
another allied address space, but the connection type is dif- 
ferent. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. The ally attempting to connect 
to DB2 should have produced diagnostic information relating to 
the connection failure. 


[ : ~ Internal DB2 Information | 


This DB2 reason code is issued by the following CSECT(s): 
DSN3ID30, DSN3RIAO, DSNSRISO. 


eee ae End of Internal DB2 Information ale re eel 


System Action: The connection request is rejected. 


System Programmer Response: Collect the diagnostics 
produced by the allied address space which could not connect 
to DB2. 


Problem Determination: Follow the instructions indicated by 
the diagnostics to assure that a different connection name will 
be used on future attempts to connect to DB2. 


00F30024 


Explanation: The 'connection name' or ‘connection type’ 
does not match the name or type established by another con- 
nected task in the address space. 


DB2 Codes 4-255 


00F30025 — 00F30028 


a — Internal DB2 information | 


This reason code is issued by the following CSECT(s): 
DSN3ID30 


asec to End of Internal DB2 Information ra eee: | 


System Action: The connection request is denied. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: All tasks within an address space con- 
necting to the same DB2 subsystem must connect with the 
same connection name and type. Tasks within TSO and batch 
address spaces using the 'BATCH' connection type may 
specify unequa/ connection names. The failure is probably the 
result of a logic error in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 48. 


00F30025 


Explanation: A request to establish a DB2 termination ECB has 
completed successfully; however, DB2 is stopping. The new 
termination ECB might not be posted. 


i = Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSN3EXTO 


————s End of Interna! DB2 Information Pee | 


System Action: Control is returned to the attachment facility. 


User Response: Since DB2 is stopping, you should attempt to 
terminate your connection. Next, issue a connect request and 
provide a Startup ECB. When the Startup ECB is posted, issue 
the connect request again to re-establish your connection to the 
restarted DB2. 


00F30026 


Explanation: The attachment facility specified an invalid 
FRBFVLE value. The value is outside the limits of those sup- 
ported for the requesting connection. 


Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


aes End of Internal DB2 Information SoA sd cecil 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility and requesting application. 


Problem Determination: Register 1 contains a pointer to the 
FRB at the entry to DSNAPRHO or DSNAPRHX. FRBFVLE con- 
tains the invalid value that was passed. The value passed must 
not be zero and it must be consistent with the resource 
requested by FRBRALE. 
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00F30027 


Explanation: An error occurred while processing the 
‘Weighting Factor' parameter. This parameter was provided 
by the attachment facility on a request to allocate a DB2 pian to 
the application. 


Either an abend occurred accessing the 'Weighting Factor'.or 
the value of the parameter is out of range. 


oe ~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3CT30 


neat End of Internal DB2 Information | 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: For the abend case, this reason code 
is placed in register 15 to identify which parameter was not 
addressable in the caller’s PSW key. The value of the 
‘Weighting Factor' must be a positive number between zero 
and 255. The failure is probably the result of a logic error in the 
attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30028 


Explanation: This reason code is returned when previous inv- 
ocations of DB2 have set the thread into a state such that the 
only acceptable request that can be made for the thread is 
ABORT. This could occur, for example, if the ally has issued 
“Prepare to Commit” and DB2 returned a ”No” vote on the call. 
In this situation, the only acceptable request for the ally to make 
is ABORT. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. The ally may have produced 
diagnostics to report this condition, or it may handle this condi- 
tion internally without requiring outside intervention. 


| : Internal DB2 Information ~ aia, 


This DB2 reason code is issued by the following CSECT(s): 
DSN3ID30 


eae eee End of Internal DB2 Information Suprsace tisha 


System Action: The current allied request is rejected. The 
state of the thread is unchanged. 


System Programmer Response: Collect any diagnostics 
produced by the allied address space. 


Problem Determination: Follow the instructions indicated by 
the diagnostics, if any. 


00F30029 


Explanation: This reason code is returned when a COMMIT 
request is received in an improper context. Either a PREPARE 
is required before the COMMIT request, or the connection type 
does not allow a COMMIT request. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


| Internal DB2 Information foe nee ea 


This DB2 reason code is issued by the following CSECT(s): 
DSN3CMO00, DSN3TROO 


= End of Internal DB2 Information | 


System Action: The current allied request is rejected. The 
state of the thread is unchanged. 


00F30030 


Explanation: An abend has occurred during an attempt to 
access the caller-provided 'INDOUBT RESOLUTION ' parameter 
while executing in the PSW key. This is probably the result of a 
logic error in the requesting program. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3RIAO, DSNSRIMO 


eee ee End of Internal DB2 Information _ 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


Problem Determination: This reason code is placed in register 
15 during any access to caller-provided information. When any 
abend occurs this register indicates which parameter caused 
the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00F30031 


Explanation: This reason code is returned when a DEALLO- 
CATE request is received from a CICS or IMS/VS thread, but 
PREPARE has already completed for the thread and either 
COMMIT or ABORT are the only acceptable requests. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


| Internal DB2 Information aaa. 


This DB2 reason code is issued by the following CSECT(s): 
DSN3TROO 


te ota ane End of Internal DB2 Information _ 


System Action: The current allied request is rejected. The 
state of the thread is unchanged. The ally issuing the DEALLO- 
CATE request may have produced diagnostics related to this 
error. 


00F30029 — 00F30034 


System Programmer Response: Collect the diagnostics 
produced by the allied address space, if any. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F30032 


Explanation: An error occurred while processing the 'Indoubt 
Resolution' parameter. This parameter was provided by the 
attachment facility on a request to allocate a DB2 plan to the 
application. 


Either an abend occurred accessing the 'Indoubt Resolution’ 
or the value of the parameter is incorrect for this connection 


type. 


j- = Internal DB2 Information ~~ “oy 


This abend reason code is issued by the following CSECT(s): 
DSN3CT30 


Lo End of Internal DB2 Information Boge 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: For the abend case, this reason code 
is placed in register 15 to identify which parameter was not 
addressable in the caller’s PSW key. For TSO, batch, and Call 
Attachment connections, the value of the 'Indoubt Resolution’ 
parameter must be 'NO'. The failure is probably the result of a 
logic error in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30033 


Explanation: An abend has occurred during an attempt to 
access the 'Plan Name' parameter while executing in the 
caller's PSW key. 


‘a ~~~ Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSN3CT30 


geet End of Internal DB2 Information ie Be 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: This reason code is placed in register 
15 to identify which parameter was not addressable in the 
caller’s PSW key. The failure may be the result of a logic error 
in either the attachment facility or the requesting application. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30034 


Explanation: The authorization ID associated with this con- 
nection is not authorized to use the specified plan name. 


DB2 Codes 4-257 


00F30035 — 00F30039 


| Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3CT30, DSN3SI30 


Ue eetteaces ioe End of Internal DB2 Information oe el 


System Action: The request to allocate a plan to the authori- 
zation ID is denied. 


User Response: You must request execution authority to the 
plan from either the owner of the plan or from another person 
given the authority to grant execution authority to the plan. 


00F30035 


Explanation: An abend has occurred during an attempt to 
access the caller-provided authorization iD while executing in 
the PSW key of the caller. This is probably the result of a logic 
error in the requesting program. 


| Internal DB2 Information om | 


This abend reason code is issued by the following CSECT(s): 
DSN3SI30 


eee eee End of Internal DB2 Information ea oer 


System Action: The request is not processed. 
User Response: A dump should be taken for probiem analysis. 


Problem Determination: This reason code is placed in register 
15 during any access to caller-provided information. When any 
abend occurs this register indicates which parameter caused 
the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30036 


Explanation: This reason code may be returned during con- 
nection processing for a coordinator thread if a coordinator for 
that connection name already exists. This may be a case of two 
IMS/VS or CICS systems using the same connection name. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. The ally attempting to connect 
to DB2 should have produced diagnostic information relating to 
the connection failure. 


| ~ Internal DB2 Information ~ | 


This DB2 reason code is issued by the following CSECT(s): 
DSN3ID30 


Beg eee End of Internal DB2 Information ees: 


System Action: The connection request is rejected. 


System Programmer Response: Collect the diagnostics 
produced by the allied address space which could not connect 
to DB2. 


Probiem Determination: Follow the instructions indicated by 
the diagnostics to ensure that a different connection name will 
be used on future attempts to connect to DB2. 
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00F30037 


Explanation: This reason code may be returned during con- 
nection processing for a CICS or IMS/VS dependent (non- 
coordinator) thread if a coordinator for that connection name 
does not already exist. This may be an internal error in CICS, 
IMS/VS, or the attachment package. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. The ally attempting to connect 
to DB2 should have produced diagnostic information relating to 
the connection failure. 


| Internal DB2 Information 


This DB2 reason code is issued by the following CSECT(s): 
DSN3ID30 


ee End of Internal DB2 Information ee | 


System Action: The connection request is rejected. 


System Programmer Response: Collect the diagnostics 
produced by the allied address space which couid not connect 
to DB2. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F 30038 


Explanation: An abend has occurred during an attempt to 
access the 'Correlation ID' parameter while executing in the 
caller’s PSW key. 


oe es Internal DB2 Information ~~ ict 


This abend reason code is issued by the following CSECT(s): 
DSN3CT30, DSN3SI30 


| snd of internal DB2 Information | 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: This reason code is placed in register 
15 to identify which parameter was not addressable in the 
caller’s PSW key. The failure is probably the result of a logic 
error in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30039 


Explanation: This reason code may be returned on a PREPARE 
request if Network ID (NID) is specified, but NID was previously 
specified on the CREATE THREAD request. NID cannot be 
specified on both requests. This may be an internal error in 
CICS, IMS/VS, or the attachment package. 


This reason code is not normally visibie to users or operators, 
but may appear in DB2 traces. The ally issuing the PREPARE to 
DB2 should have produced diagnostic information relating to 
the connection failure. 


| Internal DB2 Information | 


This DB2 reason code is issued by the following CSECT(s): 
DSN3PRO0 


Ue ees End of Internal DB2 Information poe Soe esl 


System Action: The PREPARE request is rejected. 


System Programmer Response: Collect the diagnostics 
produced by the allied address space which had the failing 
request. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F30040 


Explanation: The allocation of the plan to the connection failed. 
Either a resource is unavailable or the requested resource 
(plan) is not known to DB2. 


Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3CT30 


eee, End of Internal DB2 Information Banas hood 


System Action: Information on the failing resource name, 
object type, and a Database Services reason code, that help to 
explain the allocation failure, are returned to the attachment 
facility. 


User Response: Unknown plans must be bound before they 
can be accessed. 


Call Attachment users may invoke the TRANSLATE function to 
move the information returned to the attachment facility into the 
error message field SQLERRMT in the SQLCA. 


System Programmer Response: Refer to message DSNT500! 
for identification of unavailable resources and diagnostics to be 
collected. Refer to Figure 4 in Appendix B, “Problem 
Determination” on page X-5 for an explanation of resource type 
codes. 


Problem Determination: See response suggestions above. 


00F30042 


Explanation: An abend has occurred during an attempt to 
access the caller-provided recovery coordinator option while 
executing in the PSW key of the caller. This is probably the 
result of a logic error in the requesting program. 


| ~— Internal DB2 Information ~——_—————S “a 


This abend reason code is issued by the following CSECT(s): 
DSN3ID30 


—— End of Internal DB2 Information tee he 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


Problem Determination: . This reason code is placed in register 
15 during any access to caller-provided information. When any 





00F30040 — 00F30045 


abend occurs this register indicates which parameter caused 
the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30043 


Explanation: A terminate request was received with the 
‘Deallocate' option, but a Unit of Recovery is still outstanding 
for the connection. Either 'SYNC' or 'ABRT' must be 
requested before resources can be deallocated. 


-Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3TROO 


[evpatesat 2s End of Internal DB2 Information ee ee 


System Action: The termination request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility or requesting application. 


Problem Determination: This failure is probably the result of a 
logic error in the attachment facility or a DB2 connection man- 
agement error. This reason code is placed in register 0 and the 
return code is placed in register 15. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 81 on page X-6 


00F30044 


‘Explanation: This reason code is returned when a DEALLO- 


CATE request is received with uncommitted work outstanding. 
Either the PREPARE, COMMIT sequence or an ABORT request 
is required. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


Internal DB2 Information 


This DB2 reason code is issued by the following CSECT(s): 
DSN38TROO 


Me End of Internal DB2 Information oat eed 


System Action: The current allied request is rejected. The 
state of the thread is unchanged. The ally issuing the DEALLO- 
CATE request may have produced diagnostics related to this 
error. 


System Programmer Response: Collect the diagnostics 
produced by the allied address space, if any. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F30045 


Explanation: An error has occurred while attempting to locate 
the Unit of Recovery associated with a DISPLAY, COMMIT, or 
ABRT request. This is probably the result of a logic error in the 
requesting program. 


DB2 Codes 4-259 


00F30046 — 00F30050 


| internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN3RIAO, DSNSRIMO 


Poca thts End of Internal DB2 information bos ras et 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


Problem Determination: This reason code is placed in register 
0 and the return code is placed in register 15. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 21, 22, 23, 24, 25. 


00F30046 


Explanation: A terminate request was received with the 
‘Commit' option, but this option is not supported for this con- 
nection type. Only the 'SYNC' or 'ABRT' options are valid for 
TSO, batch, and Call Attach connections. 


(oe Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSN8TROO 


[ End of Internal DB2 Information _ 


System Action: The termination request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility or requesting application. 


Problem Determination: This failure is probably the result of a 
logic error in the attachment facility. 


00F30047 


Explanation: This reason code is returned when a RECOVER 
INDOUBT-ABORT request is received from a CICS or iIMS/VS 
recovery coordinator, but the thread is already in the process of 
COMMITing. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


‘ae Internal DB2 Information 


This DB2 reason code is issued by the following CSECT(s): 
DSNS3RIAO 


St sete ree End of Internal DB2 Information ett A 


System Action: The current allied request is rejected. The 
state of the thread is unchanged. The ally issuing the 
RECOVER INDOUBT-ABORT request may have produced diag- 
nostics related to this error. 


System Programmer Response: Collect the diagnostics 
produced by the allied address space, if any. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 
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00F30048 


Explanation: An abend has occurred during an attempt to 
access the attachment-provided ‘Network ID' while executing 
in the caller’s PSW key. 


[- Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3CT30, DSN3PROO 


Le End of internal DB2 Information ____] 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: This reason code is placed in register 
15 to identify which parameter was not addressable in the 
caller’s PSW key. The failure is probably the result of a logic 
error in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30049 


Explanation: A request was received to connect the 
requestor’s TCB to a DB2 subsystem, but the TCB is already 
connected. 


| Internal DB2 Information — Se a I 


This reason code is issued by the following CSECT(s): 
DSN3ID30 


Pete themed End of Internal DB2 Information eee) 


System Action: The connection request is rejected. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Obtain all dumps taken by the 
attachment facility or requesting application. 


Problem Determination: The failure is probably the result of a 
logic error in the attachment facility. 


00F30050 


Explanation: A DB2 request has been received after a failure 
during a previous request and cleanup of the previous request 
did not complete. This can happen if DB2 recovery was 
bypassed on a previous request. This bypass occurs if the 
application has an enabled unlocked task (EUT) FRR active and 
requested a retry back to the application mainline code. 


Internal DB2 Information | 


This reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


Diets End of Internal DB2 Information Seeeee 


System Action: The request is not processed. DB2 wil! termi- 
nate the connection when the TCB terminates. 


User Response: You must terminate your task. Do not attempt 
further DB2 requests. Do not request terminating the con- 
nection. You should request a dump for problem analysis. 


System Programmer Response: See Problem Determination. 


Problem Determination: The diagnostic data should be exam- 
ined for prior failures while processing a request for this con- 
nection. Users of the call attachment facility cannot retry from 
an EUT FRR routine if an error occurs during DB2 processing. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 48. 


00F30051 


Explanation: This reason code is returned when a RECOVER 
INDOUBT request is received from a CICS or IMS/VS recovery 
coordinator, but the thread is still processing in DB2 code other 
than EOT. The request cannot be processed at this time but 
may be successful if issued again later. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


| Internal DB2 Information = ~ | 


This DB2 reason code is issued by the following CSECT(s): 
DSN3RIAO 


oe cee eek hs End of Internal DB2 Information _ 


System Action: The current allied request is rejected. The 
state of the thread is unchanged. The ally issuing the 
RECOVER INDOUBT request may have produced diagnostics 
related to this error. 


System Programmer Response: Collect the diagnostics 
produced by the allied address space, if any. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F30052 


Explanation: The caller’s connection with DB2 has been termi- 
nated, because the calier’s recovery coordinator has already 
terminated. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


ee oe End of Internal DB2 Information rash tka 


System Action: The request has been processed by termi- 
nating the agent. 


User Response: Your application program may identify to DB2 
when its recovery coordinator has identified again. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
5. 


00F30051 — 00F30055 


00F30053 


Explanation: An error occurred while processing the 'Current 
Level' parameter. This parameter was provided by the attach- 
ment facility on a termination request. 


Either an abend occurred accessing the 'Current Level' or the 
value of the parameter is invalid. 


r ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3CT80, DSN3ID80, DSN3SI80 


{ End of Internal DB2 Information aes 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 
System Programmer Response: See Problem Determination. 


Problem Determination: For the abend case, this reason code 
is placed in register 15 to identify which parameter was not 
addressable in the caller’s PSW key. The value of the 'Current 
Level’ parameter must be zero or a number representing the 
connection’s authority level. The failure is probably the result 
of a logic error in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 5, 48. 


00F30054 


Explanation: The value of the 'Current Level’ parameter does 
not match the current authority level of the connection. This 
parameter was provided by the attachment facility on a termi- 
nation request. 


| Internal DB2 Information ee “| 


This reason code is issued by the following CSECT(s): 
DSN3CT80, DSN3ID80, DSN3SI80 


eee End of Internal DB2 Information re eer 


System Action: The request is not processed. 
User Response: A dump should be taken for problem analysis. 


System Programmer Response: Collect all dumps taken by the 
attachment facility or requesting application. 


Problem Determination: The failure is probably the result of a 
logic error in the attachment facility. 


00F30055 


Explanation: The maximum number of concurrent identify level 
agents has been exceeded. 


pa es oe Internal DB2 Information Pe yee 
This abend code is issued by the following CSECT(s): DSN3ID30 


eee aes End of Internal DB2 Information eee: 


System Action: The connection request is not processed. 


User Response: Attempt connection to DB2 at a later time. 
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O00F30056 — 00F30061 


System Programmer Response: Ensure that the system 
parameters controlling the maximum number of concurrent 
identifies are correct. 


00F30056 


Explanation: An IDENTIFY request for connection to DB2 was 
rejected. DB2 had been started in restricted access mode. 
Only authorization IDs authorized to perform maintenance func- 
tions are permitted access to DB2. 


a Internal DB2 Information ~~ 


This reason code is issued by the following CSECT(s): 
DSN3ID30. 


Oe ees End of Internal DB2 information atten | 


System Action: The connection request is not processed. 


User Response: Retry the connection request after DB2 has 
been restarted in full access mode. 


00F30057 


Explanation: An invalid application-supplied address was 
encountered while accessing the application-provided data. 


ee ~~ Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNAET03, DSNAPRHO, DSNAPRHX 


oe ena Pa End of Internal DB2 Information Ponca od 


System Action: The application program is abended with code 
X'04E' and this reason code. 


System Programmer Response: Obtain the dump printout from 
the application programmer. Refer to Section 5 of Diagnosis 
Guide and Reference for failure analysis procedures. 


Problem Determination: The register contents at the time of 
abend are as follows: 


R2 A decimal code identifying the bad data: 


1 FRB address is invalid. 
2 FRBPARM contains an invalid RDIIN address. 
18 RDICODEP contains an invalid SQLCA 


address. 
R3 The invalid application data area address. 
R4 The address of the RDIIN. 
R5 The virtual storage key of the data. 
R8 The address of the FRB in the application address 
space. 


Collect the following diagnostic item listed in Appendix B, 
“Problem Determination” on page X-5: 4. 


OQOF30058 


Explanation: Access to DB2 has been denied by the site’s 
authorization exit. 
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r tr ee internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSN3ID40, DSN3S140 


Bites oe End of Internal DB2 Information eee east | 


System Action: The request is not processed. 


User Response: Contact your security administrator and 
request authority to access this DB2 subsystem. 


System Programmer Response: No action is necessary unless 
the request denial was in error. If it was, the authorization exit 
should be tested to determine the cause of the error. 


00F30059 


Explanation: The return code from the authorization exit was 
not valid. Field EXPLARC must be set by the authorization exit 
to either 0 or 12. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3ID40, DSN3SI40 


Wh cnsee wave acer End of Internal DB2 Information 23st aes 


System Action: The request is not processed. 


System Programmer Response: Diagnostics obtained for the 
failure must be analyzed and the exit corrected. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
5. 


00F30060 


Explanation: Upon return from an authorization exit, the 
returned value of the SQL ID was not equal to either the 
returned primary or one of the returned secondary authori- 
zation IDs. 


| —s Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3/D40, DSN3SI40 


[| End of interna! DB2 Information ____| 


System Action: The request is not processed. 


System Programmer Response: Diagnostics obtained for the 
failure must be analyzed and the exit corrected. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
5. 


00F30061 


Explanation: An abend occurred while referencing the SIGNON 
request’s secondary authorization ID parameter provided by 
the attachment facility. 


| ~~ _ internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SI30 


ee End of internal DB2 Information eee 


System Action: SIGNON processing is terminated. 


System Programmer Response: Analyze the diagnostic data to 
determine which attachment module may have been in error. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: This reason code is placed in register 
15 to identify which parameter was not addressable with the 
caller’s PSW key. The failure is probably the result of an error 
in the attachment facility. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30062 


Explanation: Upon return from the SIGNON authorization exit, 
the returned value of the primary authorization ID is null. The 
first character is less than or equal to X'40'. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SI40 


[eee ee End of Internal DB2 Information eer caeazt || 


System Action: The request is not processed. 


System Programmer Response: Diagnostics obtained for the 
failure must be analyzed and the exit corrected. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 2, 
5. 


OO0F30063 


Explanation: The DB2 attachment facility for IMS or CICS pro- 
vided a secondary authorization ID value, but no primary 
authorization ID value. This is a violation of the SIGNON pro- 
tocol. 


[ ooo ee Keg! : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SI30 


Sere er ens End of Internal DB2 Information ete 


System Action: The SIGNON request is terminated with a 
return code of 12 and this reason code. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. 


| 


| 
| 


00F30062 — 00F30065 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
21, 22, 23, 24, 25, 48. 


This is probably an error in the attachment facility. 


00F30064 


Explanation: The DB2 attachment facility for IMS or CICS did 
not provide a value for the primary authorization ID, and the 
current primary authorization ID is also null. This is a violation 
of the SIGNON protocol. A user’s connection must have an 
associated primary authorization ID. 


Internal DB2 Information == ad 


This abend reason code is issued by the following CSECT(s): 
DSN3SI30 


—_———a a End of Internal DB2 Information Pe beeches 


System Action: The SIGNON request is terminated with a 
return code of 12 and this reason code. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 
21, 22, 23, 24, 25, 48. 


This is probably an error in the attachment facility. 


O0OF30065 


Explanation: An error occurred in determining the commit 
state of the thread. 


hee: ~~~ Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSN3PRO0, DSN3CMO00, DSN3AB00 


oer End of Internal DB2 Information ae 


System Action: The caller is abended in DSN3PRO0 and 
DSN3CMO00. In DSN3AB00 a dump is taken and an abort is 
attempted. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Obtain the dump printout. 
Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced. These can be used to 
locate the areas for examination, especially the RAL in the 
dump. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 
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OOF30066 — 00F30104 


00F 30066 


Explanation: An abend occurred during an attempt to access 
the caller-provided ACEE address field while executing in the 
PSW key of the caller. This is probably the result of a logic 
error in the requesting program. 


System Action: The sign-on request is not processed. 


User Response: You may retry from your recovery routine 
(ESTAE) and continue execution with the same level of capa- 
bility you had before the request that abnormally terminated. 


Problem Determination: The reason code is placed in register 
15 prior to any access to caller-provided information. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30080 


Explanation: CSECT DSNAPRHX or DSNAPRHO was unable to 
cancel its ESTAE. 


| Internal DB2 Information - tee | 


This abend reason code is issued by the following CSECT(s): 
DSNAPRHX, DSNAPRHO 


[et oe a End of internal DB2 Information Min Peers acest 


System Action: The application program is abended with code 
X'04E' and this reason code. 


User Response: Notify the system programmer. The applica- 
tion may be retried. 


System Programmer Response: See Problem Determination. 


Probiem Determination: A non-zero return code was received 
from the Cancel ESTAE operation. The return code has been 
placed into Register 2. Refer to either the MVS/ESA or the 
MVS/XA System Programming Library: Supervisor Services and 
Macro Instructions manual for the meaning of the return code. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 4, 5. 


00F30101 


Explanation: The parameter contained in the IEFSSNxx 
member used to initialize DB2 (and other subsystems) is in 
error. Refer to message DSN3101I for details. 


System Action: See message DSN3101I. 

User Response: See message DSN31011. 

Operator Response: See message DSN31011. 

System Programmer Response: See message DSN31011. 
Problem Determination: See message DSN3101I. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30102 


Explanation: The parameter contained in the IEFSSNxx 
member used to initialize DB2 (and other subsystems) is in 
error. The DB2 subsystem recognition character must be not 
be blank. For details, see message DSN3102I. 
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vos Internal DB2 Information | 


This abend code is issued by the following CSECT(s): 
DSN3URO00 


a End of Internal DB2 Information SSenatace esl 


System Action: See message DSN3102I. 

User Response: See message DSN31021. 

Operator Response: See message DSN3102I. 

System Programmer Response: See message DSN3102I. 
Problem Determination: See message DSN3102I. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30103 


Explanation: The parameter contained in the IEFSSNxx 
member used to initialize DB2 (and other subsystems) is in 
error and/or the named module is not resident in a library 
available during IPL. Refer to message DSN3103! for details. 


Internal DB2 Information ja a 


This abend code is issued by the following CSECT(s): 
DSN3URO0 


eee End of Internal DB2 Information eee | 


System Action: See message DSN31031. 

User Response: See message DSN3103i. 

Operator Response: See message DSN3103I. 

System Programmer Response: See message DSN3103I. 
Problem Determination: See message DSN3103!I. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30104 


Explanation: Module DSN3UR00 was unable to obtain the DB2 
subsystem affinity table index for the named subsystem. MVS 
did not recognize the named subsystem. Refer to message 
DSN3109i for details. 


‘ae ~—— Internal DB2 Information : ae | 


This abend code is issued by the following CSECT(s): 
DSN3URO00 


—— eee End of Internal DB2 Information eee 


System Action: See message DSN3109I. 

User Response: See message DSN3109I. 

Operator Response: See message DSN3109I. 

System Programmer Response: See message DSN3109I. 
Problem Determination: See message DSN3109I. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-S5: 1, 2, 5. 


00F30105 


Explanation: Module DSN3URO00 was unable to load Early 
module 'DSN3EPX'. Either there was an I/O error, or the 
named module is not resident in a library available during IPL. 
Refer to message DSN3105! for details. 


[ 7 Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3UR00 


Ue ess End of Internal DB2 Information eee) 


System Action: See message DSN3105). 

User Response: See message DSN3105I. 

Operator Response: See message DSN31085I. 

System Programmer Response: See message DSN31085I. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: See message DSN3105I. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page: X-5: 1, 5. 


00F30111 


Explanation: The DB2 program which establishes DB2 as an 
MVS subsystem during Master Scheduler initialization has 
determined that either its own load module or a load module 
loaded by it does not have the attributes AMODE(31) and 
RMODE(ANY). Message DSN3111I was issued just prior to the 
abend. This message contains the name of the load module in 
error. 


‘ae ~~~ Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSN3UROO. 


| Ss End of Internal DB2 Information _____——_ 


System Action: DB2 subsystem initialization is terminated. 
System Programmer Response: See message DSN3111I. 
Operator Response: See message DSN3111Il. 


Problem Determination: See message DSN31111. 


00F30203 


Expianation: This reason code is returned when a DB2 
program attempts to either activate an already active SS! func- 
tion code or deactivate an already inactive SSI function code. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


| Internal DB2 Information | 


This DB2 reason code is issued by the following CSECT(s): 
DSN3ACOX, DSN3AC00 


Picea 2a seta End of Internal DB2 Information ae 


System Action: None. 


00F30105 — 00F30211 


00F30210 
Explanation: One of these conditions exists: 


¢ Module DSN3RS00 or DSN3RSOX received a nonzero return 
code from ENQ (exclusive). 

¢ Module DSN3ENQ0 received a nonzero return code from 
ENQ (shared) and the indication was other than 'the task 
already has the resource enqueued'. 


This is a serious error. 


| : ~ Internal DB2 Information ~ =e 


This abend reason code is issued by the following CSECT(s): 
DSN3ENQ0, DSN3RSO0, DSN3RSOX 


ee End of Internal DB2 Information eae 


System Action: The caller is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: To determine the error return 
from the ENQ SVC, examine the SVC dump. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced. Register 2 at the time of 
the abend contains the value passed back by ENQ in register 
15. This can be used to locate the response area. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30211 
Explanation: One of the following conditions exists: 


* Module DSN3DEQO wanted to release the resource uncon- 
ditionally but did not have it to release. 


* Module DSN3RSO0 or DSN3RSOX received a nonzero return 
code from DEQ and the indication was other than ‘the task 
had not been assigned control’. 


This is a serious error. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3DEQO0, DSN3RS00, DSN3RSOX 


ee End of Internal DB2 Information ates] 


System Action: The caller is abended. The current request 
has probably been processed completely. However, proc- 
essing serialization may not have been maintained. 


Operator Response: Notify the system programmer. 


System Programmer Response: To determine the error 
returned from the DEQ SVC, examine the SVC dump. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced. Register 2 at the time of 
the abend contains the value passed back by DEQ in register 
15. This can be used to locate the response area. 


Collect the following diagnostic items listed in Appendix. B, 
“Problem Determination” on page X-5: 1, 2, 5. 
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00F30212 — 00F30216 


00F30212 


Explanation: A function that is allowed only for DB2 key callers 
was invoked by a supervisor state caller in another key. 
(Problem state callers receive system X'0C2' abend com- 
pletion codes instead.) 


oe =. Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3AC00, DSNSACOX 


| End of Internal DB2 Information _ 


System Action: The caller is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: To determine the DB2 service 
module running in the wrong PSW key, examine the SVC dump. 


Problem Determination: [f the invoker is a DB2 service module, 
an SVC dump and associated SYS1.LOGREC entries are 
produced. The invoker should have been in DB2 KEY during 
the invocation. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30213 


Explanation: The invoker of module DSN3AC00 or DSN3ACOX 
passed an invalid action code. The only valid codes are 0 
(deactivate) and 1 (activate). 


| —_ Internal DB2 Information Sees eee | 


This abend reason code is issued by the following CSECT(s): 
DSN3ACO00, DSN3ACOX 


| EEnd of internal DB2 Information _____—__— 


System Action: The caller is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: To determine the caller of the 
activate and deactivate service module, examine the SVC 
dump. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced by a DB2 service module. 
The save area chain should indicate the invoker of this service 
module. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30214 


Explanation:. The invoker of module DSN3AC00 or DSN3ACOX 
passed an invalid SSOB function code. The valid codes range 
from 1 to 255. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3ACO00, DSN3ACOX 


Pe eee, End of Internal DB2 Information tae ea 
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System Action: The caller is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: To determine the caller of the 
activate and deactivate service module, examine the SVC 
dump. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced by a DB2 service module. 
The save area chain should indicate the invoker of this service 
module. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30215 


Explanation: The invoker of module DSN3ACO00 or DSN3ACOX 
passed an invalid 'QUEUE' parameter. The storage provided 
could not be modified in the DB2 PSW key. 


| Interna! DB2 Information as | 


This abend reason code is issued by the following CSECT(s): 
DSN3AC00, DSN3ACOX 


[dette ose End of Internal DB2 Information eee) 


System Action: The caller is abended with system completion 
code of X'0C4'. 


Operator Response: Notify the system programmer. 


System Programmer Response: To determine the caller of the 
activate and deactivate service module, examine the SVC 
dump. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced by a DB2 service module. 
The save area chain should indicate the invoker of this service 
module. The invoker should have set a correct parameter 
value before invoking module DSN3ACO00 or DSN3ACOX. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30216 


Explanation: The ASCB for the newly created DB2 subsystem 
services address space could not be located. The presumption 
is that the DB2 subsystem has not been started successfully. 
Further entry of commands to the DB2 subsystem results in 
attempts to start DB2. 


Interna! DB2 Information == ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNSECO00, DSN3ECOX 


ea ete eo End of Internal DB2 Information | 


System Action: The current -START command processing is 
terminated. Subsequent commands are processed as though 
this command had not been processed. 


Operator Response: Retry the command. If the command fails 
again, notify the system programmer. 


System Programmer Response: If the command fails again, 
request an IPL of MVS, as the failure may be the result of an 
MVS internal problem. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced. The ASID passed back by 
the MVS command scheduler for the -START command is not 
valid. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30217 


Explanation: The console |D for the MVS console that entered 
the current command is not found in the MVS unit control 
module (UCM) structure. This is a serious error. An internal 
MVS START command may have been incorrectly issued by an 
application program that provided invalid input parameters. 


Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSN3ECO00, DSN3SECOX 


Ree End of internal DB2 Information eel 


System Action: The caller is abended. 


Operator Response: Retry the -START DB2 command. If the 
command fails again, notify the system programmer. 


System Programmer Response: If the command fails again, 
request a stand-alone dump and an IPL of MVS, as this may be 
due to an MVS internal problem. 


Probiem Determination: Tne SSOB command extension 
mapped by IEFSSCM contains the invalid console ID. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30218 


Explanation: The ERLY block for this DB2 subsystem is in 
error. The control word that manages command processing is 
in an undefined state. This is a serious error. 


| internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3ECO0, DSN3ECOX 


an End of Internal DB2 Information ete a2) 


System Action: The current TCB is abended. Two possible 
reasons are: 


¢ There is no DB2 subsystem services address space. There- 
fore, the initial command state can safely be set in the 
control word, and the current command can be treated as a 
‘first' (START) command. Processing of the command 
continues. 

¢ The system services address space ASID is known, but the 
state of the DB2 subsystem is uncertain. In this case, the 
command facility is considered disabled, and message 
DSN3108I is returned to the issuer of the command. 


Operator Response: Notify the system programmer. 


System Programmer Response: Examine the ERLY block field 
ERLYCMST. If the value of ERLYCMST is greater than 2, the 
field is in error. 


Problem Determination: The calling TCB may have requested 
an SVC dump or created associated SYS1.LOGREC entries. 


00F30217 — 00F3021B 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30219 


Explanation: The ERLY block for this DB2 subsystem is in 
error. The control word that manages EOM broadcast proc- 
essing is in an undefined state. This is a serious error. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3EC00, DSN3ECOX 


———as End of Internal DB2 Information eee 


System Action: The calling TCB is abended. 


Operator Response: Cancel DB2. (End of task processing may 
still work, and it does a more complete clean-up than end-of- 
memory processing does.) If this does not work, issue the MVS 
FORCE command for the DB2 address spaces. If the problem is 
still unresolved, request a stand-alone dump and re-IPL MVS. 


System Programmer Response: Examine the ERLY block fieid 
ERLYEMST. if the value of ERLYEMST is greater than 2, it is in 
error. 


Problem Determination: The calling TCB may have requested 
an SVC dump or created associated SYS1.LOGREC entries. 


Coilect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


OOF3021A 


Explanation: The ERLY block for this DB2 subsystem is in 
error. The control word that manages identify processing is in 
an undefined state. This is a serious error. 


Internal DB2 Information = 


This abend reason code is issued by the following CSECT(s): 
DSN3CLO00, DSN3CLOX 


Pe ee End of Internal DB2 Information eae oe 


System Action: The calling TCB is abended. 


Operator Response: Stop the DB2 subsystem and reissue the 
-START DB2 command. 


System Programmer Response: Examine the ERLY block field 
ERLYIDST. if the value of ERLYIDST is greater than 2, it is in 
error. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F3021B 


Explanation: A return code other than 0, 4, or 8 was received 
from the MVS internal START command processor. The 
presumption is that the DB2 subsystem has not been started 
successfully. Further entry of commands to the DB2 subsystem 
results in further attempts to start DB2. 


DB2 Codes 4-267 


00F3021C — 00F3021F 


| ~ ” Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSECO00, DSN3ECOX 


| neRrneees End of Internal DB2 Information eet ee | 


System Action: The current -START command processing is 
abended. Subsequent commands are processed as though this 
command had not been processed. 


Operator Response: Retry the command. If the command fails 
again, request a stand-alone dump and re-IPL MVS. 


System Programmer Response: Examine the SVC dump, 
LOGREC entries, and the console log for indications of an MVS 
failure. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F3021C 


Explanation: Module DSN3ECO00 or DSN3ECOX could not estab- 
lish an ESTAE during the processing of the first (presumed to 
be the -START command) command. The caller is abended. 
This can occur if the MVS system address space that is broad- 
casting the command has insufficient storage. Further entry of 
commands to the DB2 subsystem may result in a successful 
start of DB2. 


i pS ye Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNSECO0, DSN3ECOX 


| End of Internal DB2 Information ____—_| 


System Action: The caller is abended (without ABDUMP). The 
current -START command processing is terminated. Subse- 
quent commands are processed as though this command had 
not been processed. 


Operator Response: Retry the command. If the command fails 
again, request a stand-alone dump and re-IPL MVS. 


System Programmer Response: Examine the stand-alone 
dump, LOGREC entries, and the console log for indications of 
an MVS failure. 


Problem Determination: A stand-alone dump is necessary. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 50. 


00F3021D 


Explanation: Module DSN3RS00 could not establish an ESTAE 
during either the initialization or termination of the online DB2 
subsystem. The caller is abended. 


This can occur during initialization if the MVS system address 
space that is broadcasting the first command (presumed to be 
the -START command) has insufficient storage. In this case, 
further entry of commands to the DB2 subsystem may result in 
a successful start of DB2. 
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This can occur during termination if the current address space 
(usually system services, in case of EOM broadcast, an MVS 
system address space) has insufficient storage. In this case, 
after the DB2 subsystem has shut down, further entry of com- 
mands to the DB2 subsystem may result in a successful start of 
DB2. 


— iat Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3RS00 


(ome Sees End of Internal DB2 Information rary 


System Action: The caller is abended (without ABDUMP). The 
initialization is aborted, but termination proceeds. 


Operator Response: Retry the command. Ifthe failure per- 
sists, a re-IPL of MVS is necessary and the system programmer 
should be notified. A stand-alone dump should be requested 
first. 


System Programmer Response: Examine the stand-alone 
dump, LOGREC entries, and the console log for indications of 
an MVS failure. 


Problem Determination: A stand-alone dump is necessary. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5, 50. 


00F3021E 


Explanation: Module DSN3RTRO could not establish an ESTAE 
while in the process of routing contro} to the actual ESTAE 
routine. The caller (RTM) is abended. This causes the original 
error to percolate to a higher-level recovery routine and causes 
this abend to be shown in an RTM recovery environment. 


This can occur if the current address space (usually an allied 
address space) has insufficient storage. 


[oe ee oe Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSN38RTRO 


—————— End of internal DB2 Information a, 


System Action: The caller is abended (without ABDUMP). 
Operator Response: Notify the system programmer. 


System Programmer Response: Examine the usage and free 
areas in the LSQA portion of the current address space private 
area. If necessary, have the size of the private area expanded. 


Problem Determination: A SYSUDUMP is requested. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4, 5. 


O0OF3021F 


Explanation: Module DSN3RS00 or DSN3RSOX discovered that 
the SSVT was not set to its initial state at DB2 subsystem initial- 
ization or termination time. An abend is issued in order to 
record SYS1.LOGREC data and request an SVC dump. 


——_ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3RS00, DSN3RSOX 


[PANE to? End of Internal DB2 Information abe es | 


System Action: The caller is not abended. The SSVT is reset 
to its initial state. Subsystem initialization or termination con- 
tinues. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The SVC dump contains an image of 
the SSCVT and the SSVT. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30220 


Explanation: Module DSN3RS00 or DSN3RSOX discovered that 
the PRHB was not set to its initial state at DB2 subsystem initial- 
ization or termination time. An abend is issued in order to 
record SYS1.LOGREC data and request an SVC dump. 


| z internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3RS00, DSN3SRSOX 


eee ae End of Internal DB2 Information oe eset 


System Action: The caller is not abended. The PRHB is reset 
to its initial state. Subsystem initialization or termination con- 
tinues. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The associated SYS1.LOGREC entries 
and SVC dump contain the relevant information. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30310 


Explanation: A nonzero return code was received from the 
recovery manager. It is issued by module DSNSRIAO (applica- 
tion resolve-indoubt-UR) and by module DSN3RIMO (resource 
manager resolve-indoubt-UR). 


| internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNS3RIAO, DSN3RIMO 


ee ee End of Internal DB2 information ee | 


System Action: This is a DB2 error. The invoker is abended. 


Operator Response: Notify the system programmer. 


00F30220 — 00F30312 


System Programmer Response: Collect the related materials. 
Determine the cailed recovery manager module and the 
module that issued the abend. 


Problem Determination: The associated SYS1.LOGREC entry 
indicates which module issued the abend. Check the recovery 
manager resolve-indoubt exit trace for the return code. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30311 


Explanation: Module DSN3RIMO could not establish an ESTAE 
during the processing of a resolve-indoubt (RMRQ) request. 
This can occur if the current address space has insufficient 
storage. This probably leads to an abnormal termination of the 
DB2 subsystem. 


__ —= Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3RIMO 


ees End of Internal DB2 Information So Ses 


System Action: The calier is abended (without ABDUMP). 


Operator Response: Notify the system programmer, and 
restart DB2 if necessary. 


System Programmer Response: Examine the usage and free 
areas in the local system queue area (LSQA) portion of the 
current address space private area. if necessary, have the size 
of the private area expanded. 


Problem Determination: The caller should produce a 
SYS1.LOGREC entry and an SVC dump, so that the system pro- 
grammer can examine the LSQA area. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30312 


Explanation: Module DSN3RIAO could not establish an ESTAE 
during the processing of a resoive-indoubt-UR (RARQ) request. 
This can occur if the current address space has insufficient 
storage. 


[ So § wm Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSN3RIAO 


We ate End of Internal DB2 Information bee eel 


System Action: The caller is abended (without ABDUMP). 
Operator Response: Notify the system programmer. 


System Programmer Response: Examine the usage and free 
areas in the local system queue area (LSQA) portion of the 
current address space private area. If necessary, have the size 
of the private area expanded. 


Problem Determination: The caller should produce a 
SYS1.LOGREC entry and an SVC dump. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


DB2 Codes 4-269 


00F30400 — 00F30406 


00F30400 


Explanation: This reason code is returned when a DB2 
program makes a duplicate request to be called when a specific 
SSI function code is encountered on the SSI. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


[ Internal DB2 Information ~~ 


This DB2 reason code is issued by the following CSECT(s): 
DSNSSSCN 


Ls End of Internal DB2 Information oe ao) 


System Action: None by DSN3SSCN. The DB2 program which 
made the failing request will likely produce diagnostics to 
report the failure. 


System Programmer Response: Collect the diagnostics 
produced by the application program reporting the failure, if 
any. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F30401 


Explanation: This reason code is returned when a DB2 
program makes a request to no longer be called when a spe- 
cific SSI function code is encountered on the SSI, but the contro! 
block representing the original request to be called is busy and 
cannot be deleted now. The request will be honored when the 
control block is no longer busy. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


| Internal DB2 Information ~————————— | 


This DB2 reason code is issued by the following CSECT(s): 
DSN3SSDI 


ae ere End of Internal DB2 Information eee we | 


System Action: None by DSN3SSDI. The DB2 program which 
made the failing request may produce diagnostics to report the 
failure. 


System Programmer Response: Collect the diagnostics 
produced by the application program reporting the failure, if 
any. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F30402 


Explanation: This reason code is returned when a DB2 
program makes a request to no longer be called when a spe- 
cific SSI function code is encountered on the SSI, but the control 
block representing the original request to be called cannot be 
found. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 
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[ a Internal DB2 Information | 


This DB2 reason code is issued by the following CSECT(s): 
DSN3SSDi 


—————- End of internal DB2 Information ee, 


System Action: None by DSN3SSDI. The DB2 program which 
made the failing request may produce diagnostics to report the 
failure. 


System Programmer Response: Collect the diagnostics 
produced by the application program reporting the failure, if 
any. 


Problem Determination: Follow the instructions indicated by 
the diagnostics. 


00F30405 


Explanation: The DB2 subsystem was abended by module 
DSN3SSI1 because the system services address space’s job- 
step task terminated. 


(ef Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNSSSI1 


Vee pnitece = End of Internal DB2 Information ee ae 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.L.OGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error which should have recorded an entry in SYS1.LOGREC 
data set and requested an SVC dump. The SYS1.LOGREC 
entries and SVC dump(s) should be examined to determine the 
actual cause of the error. Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30406 


Explanation: The DB2 subsystem was abended by module 
DSN3SSI1 because the system services address space was 
forced to an end-of-memory condition. 


ae internal DB2 information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSNSSSI1 


feces cee. End of Internal DB2 Information et aeeaes| 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries shouid be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error that has recorded data on the SYS1.LOGREC data sets 
and requested an SVC dump. The SYS1.LOGREC entries and 
SVC dump(s) should be examined to determine the actual 
cause of the error. Refer to “DB2 Abend Completion Codes 
(X'04E' and X'04F)” on page 1-6 for information on X'04F' and 
X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30407 


Explanation: The DB2 subsystem was abended by module 
DSN3SS!I1, because the job-step task in a resource manager 
address space terminated. 


| ~~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SSI1 


{| End of Internal DB2 Information a NaS | 


System Action: The DB2 subsystem is terminated with an SVC | 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Probiem Determination: This is usually caused by a previous 
error that has recorded data on the SYS1.LOGREC data set and 
requested an SVC dump. The SYS1.LOGREC entries and SVC 
dump(s) should be examined to determine the actual cause of 
the error. Refer to “DB2 Abend Completion Codes (X'04E' and 
X'04F)” on page 1-6 for information on X'O4F' and X'04E' 
abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30408 | 


Explanation: The DB2 subsystem was abended by module | 
DSN3SSI1 because a resource manager address space was 
forced to an end-of-memory condition. 


[ _ Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNSSSI1 


Use ate End of Internal DB2 Information er ee 


00F30407 — O0F3040A 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error that has recorded data on the SYS1.LOGREC data set and 
requested an SVC dump. The SYS1.LOGREC entries and SVC 
dump(s) should be examined to determine the actual cause of 
the error. Refer to “DB2 Abend Completion Codes (X'04E' and 
X'04F)” on page 1-6 for information on X'O04F' and X'04E' 
abend completion codes. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30409 


Explanation: The DB2 subsystem was abended by module 
DSNS3SSES, because an allied task going through either end-of- 
task or one of its terminating ancestor tasks was in a DB2 must- 
complete function or was still holding DB2 latch(s). 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSSSES 


be coet eet End of internal DB2 Information ae ete 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error that has recorded data on the SYS1.LOGREC data set and 
requested an SVC dump. The SYS1.LOGREC entries and SVC 
dump(s) should be examined to determine the actual cause of 
the error. Refer to “DB2 Abend Completion Codes (X'04E' and 
X'04F)” on page 1-6 for information on X'04F' and X'04E' 
abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F3040A 


Explanation: The DB2 subsystem was abended by module 
DSNS3SSI1, because an allied address space going through end- 
of-memory had one or more agents that either were in a DB2 
must-complete function or were still holding DB2 latch(s). 


DB2 Codes 4-271 


00F3040B — 00F3040E 


| Internal DB2 Information ~ ——————C~™:*S “| 


This abend reason code is issued by the following CSECT(s): 
DSN3SSI1 


a End of Internal DB2 Information eee al 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error that has recorded data on the SYS1.LOGREC data set and 
requested an SVC dump. The SYS1.LOGREC entries and SVC 
dump(s) should be examined to determine the actual cause of 
the error. Refer to “DB2 Abend Completion Codes (X'04E' and 
X'O4F)” on page 1-6 for information on X'04F' and X'04E' 
abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F3040B 
Explanation: See message DSN3001I. 


a : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SSTM 


a ren End of Internal DB2 Information aes aee dl 


System Action: See message DSN3001I. 

User Response: See message DSN30011. 

Operator Response: See message DSN3001I. 

System Programmer Response: See message DSN30011. 
Problem Determination: See message DSN30011. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F3040C 


Explanation: The DB2 subsystem was abended because the 
SSSS IEFSSREQ service agent (EB) was in a DB2 must- 
complete function upon return from the agent services create 
allied agent function. 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3SSI2 


epi vate ete End of Internal DB2 Information Pee ae 
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System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error that has recorded data on the SYS1.LOGREC data set and 
requested an SVC dump. The SYS1.LOGREC entries and SVC 
dump(s) should be examined to determine the actual cause of 
the error. Refer to “DB2 Abend Completion Codes (X'04E' and 
X'04F)” on page 1-6 for information on X'04F' and X'04E' 
abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F3040D 


Explanation: The DB2 subsystem was abended because the 
SSSS IEFSSREQ service agent (EB) was in a DB2 must- 
complete function upon return from the agent services termi- 
nate allied agent function. 


jo Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3ID80, DSN3SSI2, DSN3SSES 


fee 5 oes End of internal DB2 Information eo Peel 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error that has recorded data on the SYS1.LOGREC data set and 
requested an SVC dump. The SYS1.LOGREC entries and SVC 
dump(s) should be examined to determine the actual cause of 
the error. Refer to “DB2 Abend Completion Codes (X'04E' and 
X'04F)” on page 1-6 for information on X'04F' and X'04E' 
abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F3040E 


Explanation: The DB2 subsystem was abended after a failure 
during processing of an IDENTIFY, COMMAND, or MVS HELP 
subsystem interface broadcast. The recovery routine 
DSN3SSES attempted to clean up processing and pass the error 
to the caller, but was unable to do so. 


— = Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SSES 


[ibe reer End of Internal DB2 Information ee 


System Action: The DB2 subsystem is terminated. 
Operator Response: The DB2 subsystem should be restarted. 


System Programmer Response: Scan the SYS1.LOGREC 
entries for the initial error and subsequent abends encountered 
by module DSN3SSES. The ESTAE DSNSSSES is established at 
least three times. Repetitive errors within the ESTAE module 
ultimately result in a subsystem termination with this reason 
code. 


Problem Determination: Collect the following diagnostic items 
listed in Appendix B, “Problem Determination” on page X-5: 1, 
2, 5. 


00F3040F 


Explanation: The DB2 subsystem was abended because a DB2 
latch, critical to the Deferred End of Task (EOT) Termination 
process, was held by an MVS dispatchable unit, normally in an 
allied address space, which was no longer being dispatched 
and was, therefore, unable to release the tatch. 


ie ~~~ Internal DB2 Information | 


This DB2 termination reason code is issued by the following 
CSECT(s): DSN3SSES, DSN3SS!1, DSN3SSI2 


[a ioe End of Internal DB2 Information ed 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. The system programmer should be notified. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materiais to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error associated with an allied address space and especially in 
the case where the allied address space has been forced to an 
end-of-memory condition. 


The console output should be examined for errors associated 
with allied address spaces. 


Collect the following diagnostic items listed in Appendix B,,. 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30410 


Explanation: The DB2 subsystem was abended, because the 
end-of-task listening module failed during a must-complete 
window. End-of-task processing is considered to be in a must- 
complete state until an ESTAE has been established. The 
‘user' of this ESTAE routine was the allied end-of-task listening 
module DSN3EOTO. 


OOF3040F — 00F30412 


[~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SAAES 


Pople End of Internal DB2 Information _ 


System Action: The DB2 subsystem is terminated. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The recovery routine DSN3AAES has 
recorded data on the SYS1.LOGREC data set and requested an 
SVC dump. The SYS1.LOGREC entries and SVC dump(s) should 
be examined to determine the cause of the error. Refer to “DB2 
Abend Completion Codes (X'04E' and X'04F)” on page 1-6 for 
information on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30411 


Explanation: The DB2 subsystem was abended because the 
abnormal termination of an agent failed during end-of-memory 
(EOM) processing for an allied address space. The ‘user' of 
this ESTAE routine was the allied EOM routine DSN3EOMO. 


na ~ Internal DB2 Information Se | 


This abend reason code is issued by the following CSECT(s): 
DSNS3AAES 


Diao es End of Interna! DB2 Information _ id 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer. DB2 may 
be started again after it terminates. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The recovery routine DSN3AAES has 
recorded data on the SYS1.LOGREC data set and requested an 
SVC dump. The SYS1.LOGREC entries and SVC dump(s) should 
be examined to determine the cause of the error. Refer to “DB2 
Abend Completion Codes (X'04E' and X'04F)” on page 1-6 for 
information on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30412 


Explanation: The DB2 subsystem was abended because the 
abnormal termination of an agent failed during resoive-indoubt 
processing for an allied agent. The ‘user' of this ESTAE 
routine was the resolve-indoubt-UR RMRQ routine DSN3RIMO. 


DB2 Codes 4-273 


00F30413 — 00F30415 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3AAES 


[| snd of Internal DB2 information ___———_—id 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer. DB2 may 
be started again after it terminates. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The recovery routine DSN3AAES has 
recorded data on the SYS1.LOGREC data set and requested an 
SVC dump. The SYS1.LOGREC entries and SVC dump(s) should 
be examined to determine the cause of the error. Refer to “DB2 
Abend Completion Codes (X'04E' and X'04F)” on page 1-6 for 
information on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30413 


Explanation: The DB2 subsystem was abended, because the 
abnormal termination of an agent failed. However, this 
recovery routine was unable to determine who its caller was. It 
should be one of the following: DSN3EOTO, DSN3EOMO, or 
DSN3RIMO. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3AAES 


{| End of internal DB2 Information Sd 


System Action: The DB2 subsystem is terminated. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The recovery routine DSN3AAES has 
recorded data on the SYS1.LOGREC data set and has requested 
an SVC dump. The SYS1.LOGREC entries and SVC dump(s) 
should be examined to determine the cause of the error. Refer 
to “DB2 Abend Completion Codes (X'04E' and X'04F)” on 

page 1-6 for information on X'04F' and X'04E' abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30414 


Explanation: The DB2 subsystem was abended, because 
module DSNSSSI1 (or its caller, DSN3CL00) was unable to 
establish the ESTAEs during the processing of a command SSI 
call. This is probably an MVS problem, because these modules 
are executing in the MVS CONSOLE address space. 
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| Internal DB2 information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SSI1 


L End of Internal DB2 Information pee 


System Action: The DB2 subsystem is terminated. 


Operator Response: DB2 may be started again after it termi- 
nates. If the failure persists, request a stand-alone dump, and 
re-IPL MVS. 


System Programmer Response: This can occur if the MVS 
system address space that is broadcasting the command has 
insufficient storage. If the problem appears to be a DB2 
problem, refer to Section 5 of Diagnosis Guide and Reference - 
for failure analysis procedures. 


Problem Determination: DB2 is unable to write a 
SYS1.LOGREC record or request a dump. The MVS CONSOLE 
function should have produced these diagnostic aids. Examine 
the dump to determine whether the problem is in MVS or DB2. 
Other unrelated failures in the MVS CONSOLE address space 
would indicate an MVS probiem. Refer to “DB2 Abend Com- 
pletion Codes (X'04E' and X'04F)” on page 1-6 for information 
on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3. 


00F30415 


Explanation: The DB2 subsystem was abnormally terminated 
because module DSN3SSI1 (or its caller, DSN3CL00) was 
unable to establish the ESTAEs during the processing of an 
EOM SSI broadcast. This is probably an MVS problem, because 
these modules are executing in the MVS master scheduler 
address space. 


| c Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNS3SSI1 


eee? End of Internal DB2 Information id 


System Action: The DB2 subsystem is terminated. 


Operator Response: DB2 may be siarted again after it termi- 
nates. If the failure persists, request a stand-alone dump and 
re-IPL MVS. 


System Programmer Response: This can occur if the MVS 
master scheduler address space has insufficient free virtual 
storage. If the problem appears to be a DB2 problem, refer to 
Section 5 of Diagnosis Guide and Reference for failure analysis 
procedures. 


Problem Determination: DB2 is unable to write a 
SYS1.LOGREC record or request a dump. The MVS master 
scheduler should have produced these diagnostic aids. 
Examine the dump to determine whether the problem is in MVS 
or DB2. Other unrelated failures in the MVS Master Scheduler 
address space would indicate an MVS problem. Refer to “DB2 
Abend Completion Codes (X'04E' and X'04F)” on page 1-6 for 
information on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3. 


00F30416 


Explanation: The DS2 subsystem was abnormally terminated, 
because module DSN3EOMO was unable to establish the ESTAE 
during the processing of an EOM for an allied address space. 


| 7. Internal DB2 Information ~——— ares 


This abend reason code is issued by the following CSECT(s): 
DSN3EOMO0 


[.__ End of internal DB2 Information een 


System Action: The DB2 subsystem is terminated. 


Operator Response: DB2 may be started again after it termi- 
nates. If the failure persists, request a stand-alone dump and 
re-IPL MVS. 


System Programmer Response: This can occur if the MVS 
master scheduler address space that is broadcasting the EOM 
has insufficient free virtual storage. If the problem appears to 
be a DB2 problem, refer to Section 5 of Diagnosis Guide and 
Reference for failure analysis procedures. 


Problem Determination: DB2 is unable to write a 
SYS1.LOGREC record or request a dump. The MVS master 
scheduler should have produced these diagnostic aids. 
Examine the dump to determine whether the problem is in MVS 
or DB2. Other unrelated failures in the MVS Master Scheduler 
address space would indicate an MVS problem. Refer to “DB2 
Abend Completion Codes (X'04E' and X'04F)” on page 1-6 for 
information on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 3. 


00F30417 


Explanation: The DB2 subsystem was abended because of a 
failure in the first end of task (FEOT) processing for a task that 
had established subsystem affinity to DB2. 


ia ~ Internal DB2 Information ~ 


This abend reason code is issued by the following CSECT(s): 
DSN3SSES 


ete tas sete End of Internal DB2 Information ee 


System Action: The DB2 subsystem is terminated. 


Operator Response: DB2 can be started again after it termi- 
nates. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather and for failure analysis procedures. 
You may also want to refer to Section 5 of Diagnosis Guide and 
Reference for information about dump analysis and service 
aids. 


Problem Determination: The recovery routine DSN3SSES has 


recorded data on the SYS1.LOGREC data set and requested an . 


SVC dump. The SYS1.LOGREC entries and SVC dump(s) should 
be examined to determine the cause of the error. Refer to “DB2 
Abend Completion Codes (X'04E' and X'04F)” on page 1-6 for 
information on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30416 — 00F30419 


00F30418 


Explanation: The DB2 subsystem was abended because of a 
failure in the end-of-memory (EQM) processing for an address 
space that had established subsystem affinity to DB2. 


aia Internal DB2 Information ~~ : : | 


This abend reason code is issued by the following CSECT(s): 
DSN3SSES 


a ers End of Internal DB2 Information ee 


System Action: The DB2 subsystem is terminated. 


Operator Response: DB2 may be started again after it termi- 
nates. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The recovery routine DSN3SSES has 
recorded data on the SYS1.LOGREC data set and requested an 
SVC dump. The SYS1.LOGREC entries and SVC dump(s) should 
be examined to determine the cause of the error. Refer to “DB2 
Abend Completion Codes (X'04E' and X'04F)” on page 1-6 for 
information on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30419 


Explanation: The DB2 subsystem was abended because a DB2 
latch, critical to the Deferred End of Task (EOT) Termination 
process, was held by an MVS dispatchable unit, normally in an 
allied address space, which was no longer being dispatched 
and was, therefore, unable to release the latch. 


| " Internal DB2 Information ~~ | 


This abend reason code is issued by the following CSECT(s): 
DSN3SSES, DSN3SSI1, DSN3SSI2 


ane End of Internal DB2 Information ee | 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: DB2 may be started again after it termi- 
nates. The system programmer should be notified. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC entries should be available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error associated with an allied address space and especially in 
the case where the allied address space has been forced to an 
end-of-memory condition. 


The console output should be examined for errors associated 
with allied address spaces. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


DB2 Codes 4-275 


00F3041A — 00F30450 


OOF3041A 


Explanation: An ESTAE could not be established by the 
deferred end-of-task (EOT) processor. This error could occur 
only during DB2 subsystem startup. Probably, an ESTAE could 
not be established because of a shortage of LSQA space. 


= ae aaa Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSEOTS 


{ End of Internal DB2 Information betel) 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: If the failure persists, increase 
the size of the system services address space private area. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC entry should be available. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F3041B 


Explanation: The deferred end-of-task (EOT) processor could 
not locate an AGNT block for the ACE of the agent in abnormal 
termination. This is a system error. 


| Internal DB2 Information = | 


This abend reason code is issued by the following CSECT(s): 
DSNS3SEOTS 


{| End of Internal DB2 Information 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: A SYS1.LOGREC entry and associated 
SVC dump were requested. Register 8 at the time of the abend 
contains the ACE pointer. The AGNT block whose AGNTEB field 
points to the EB contained within the ACE could not be located. 
Refer to “DB2 Abend Completion Codes (X'04E' and X'04F)” 
on page 1-6 for information on X‘'04F' and X'04E' abend com- 
pletion codes. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30420 


Explanation: A failure occurred during deferred end-of-task 
(EOT) processing for an agent. 
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ae Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SEOTS 


Lees kee End of Internal DB2 Information 5 easel 


System Action: The DB2 subsystem is terminated. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Determine the module that 
failed and the registers at the time of the error. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: A SYS1.LOGREC entry and associated 
SVC dump were requested. Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'O4F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30429 


Explanation: A DB2 subsystem task (normally a service task) 
going through end-of-task (EOT), or one of its terminating 
ancestor tasks, was a DB2 must-complete function or was still 
holding one or more DB2 latches. 


ce ee — Internal DB2 Information ~— | 


This abend reason code is issued by the following CSECT(s): 
DSN8SSI1 


[eee ee, End of Internal DB2 Information ee ee 


System Action: The DB2 subsystem is terminated with an SVC 
dump. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: At least one SVC dump and 
associated SYS1.LOGREC record(s) are available. Refer to 
Section 5 of Diagnosis Guide and Reference for information 
about what diagnostic materials to gather, for failure analysis 
procedures, and for information about dump analysis and 
service aids. 


Problem Determination: This is usually caused by a previous 
error that has recorded data in SYS1.LOGREC and requested 
an SVC dump. The SYS1.LOGREC record(s) and SVC dump 
should be examined to determine the actual cause of the error. 
Refer to “DB2 Abend Completion Codes (X'04E' and X'04F)” 
on page 1-6 for information on X'04F' and X'04E' abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2. 


00F30450 


Explanation: CSECT DSN3CLO0 could not establish an ESTAE 
during the processing of an identify SSI call. This can occur if. 
the current address space has insufficient storage. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3CLO00 


[ica = nee End of Internal DB2 Information —— 


System Action: The allied address space is abended (without 
ABDUMP). 


Operator Response: Notify the system programmer. 


System Programmer Response: The user may retry the iden- 
tify request. If a dump is available, review the virtual storage 
manager's control blocks to determine if all of the private area 
has been allocated. If necessary, increase the private area 
size of the allied address space. 


Problem Determination: A dump should be produced by the 
allied task. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30451 


Explanation: CSECT DSN3SSI1 could not establish its ESTAEs 
during the processing of an identify SSI call. This can occur if 
the current address space has insufficient storage. 


[ : internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3SSI1 


es End of Internal DB2 Information seen ts cel 


System Action: The ailied task is abended (without ABDUMP). 
Operator Response: Notify the system programmer. 


System Programmer Response: The user may retry the iden- 
tify request. If a dump is available, review the virtual storage 
manager’s control blocks to determine if all of the private area 
has been allocated. If necessary, increase the private area 
size of the allied address space. 


Probiem Determination: A dump should be produced by the 
allied task. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30452 


Explanation: CSECT DSN3ID30 could not establish an ESTAE 
during the processing of an identify SSI call. This can occur if 
the current address space has insufficient storage. 


| Internal DB2 Information = + 


This abend reason code is issued by the following CSECT(s): 
DSN3iD30 


We End of Internal DB2 Information ee el 


System Action: The allied task is abended (without ABDUMP). 
Operator Response: Notify the system programmer. 


System Programmer Response: The user may retry the iden- 
tify request. If a dump is available, review the virtual storage 


00F30451 — 00F30454 


manager’s control blocks to determine if all of the private area 
has been allocated. If necessary, increase the private a:ea 
size of the allied address space. 


Problem Determination: A dump should be produced by the 
allied task. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30453 


Explanation: CSECT DSN3SSI1 could not establish its ESTAEs 
during the processing of an SSI call other than FEOT, EOM, 
HELP, COMMAND, and IDENTIFY. This can occur if the current 
address space has insufficient storage. 


Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SS!1 


_— End of Internal DB2 Information ee cll 


System Action: The ailied task is abended (without ABDUMP). 
Operator Response: Notify the system programmer. 


System Programmer Response: The user may retry the 
request. If a dump is available, review the virtual storage 
manager’s contro! blocks to determine if ali of the private area 
has been allocated. If necessary, increase the private area 
size of the allied address space. 


Problem Determination: A dump should be produced by the 
allied task. 


Collect the following diagnostic items tisted in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30454 


Explanation: After discovering an error during the processing 
of an SSI call, module DSN3SSI1’s retry routine found an 
unknown retry point when it was attempting to retry into the 
mainline code. This is a DB2 subsystem error. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNS8SSI1 


ae ee End of Internal DB2 Information eeciteiesS.. So 4| 


System Action: The allied task is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: The user may retry the rele- 
vant SSI call. Refer to Section 5 of Diagnosis Guide and Refer- 
ence for information about what diagnostic materials to gather, 
for failure analysis procedures, and for information about dump 
analysis and service aids. 


Problem Determination: The recovery routine DSN3SSES has 
recorded data on the SYS1.LOGREC data set and requested an 
SVC dump. The SYS1.LOGREC entries and SVC dump(s) should 
be examined to determine the cause of the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


DB2 Codes 4-277 


00F30455 — 00F30459 


00F30455 


Explanation: CSECT DSN3ID80 could not establish its ESTAE 
during the processing of the identify termination request. This 
can occur if the current address space has insufficient storage. 


C—--— ~— Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSN3/D80 


eee oe End of internal DB2 Information Se oie ee 


System Action: The allied task is abended (without ABDUMP). 
Operator Response: Notify the system programmer. 


System Programmer Response: The user may retry the 
request. If a dump is available, review the virtual storage 
manager’s contro] blocks to determine if all of the private area 
has been allocated. If necessary, increase the private area 
size of the allied address space. 


Problem Determination: A dump should be produced by the 
allied task. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30456 


Explanation: CSECT DSN3TMO0 could not identify its caller. 
The only callers supported are: EOT, EOM, RIUR, and CNCL. 


| Internal DB2 Information -— ana 


This abend reason code is issued by the following CSECT(s): 
DSN3TMO0 


eens weer End of Internal DB2 Information en he seh 


System Action: The calling task is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The caller’s recovery routine may 
record on the SYS1.LOGREC data set and request an SVC 
dump. Module DSN3TMO00 calier’s parameter list, recorded in 
the trace entry, should be examined to determine the cause of 
the error, and new caller support should be added to 
DSN3TMOO, if necessary. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30457 


Explanation: CSECT DSN3TMO00 found that the agent termi- 
nation did not take place after an extra termination request 
(DSNARARQ). 
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Internal DB2 Information : | 


This abend reason code is issued by the following CSECT(s): 
DSN3TMO00 


———— End of Internal DB2 Information oe 


System Action: The caller is abended. The caller may, in 
many cases, eventually abend the DB2 subsystem. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The cailer’s recovery routine records 
on the SYS1.LOGREC data set and requests an SVC dump. The 
error indicates that there may be a problem with the subsystem 
support subcomponent termination routines (namely DSN3ID80, 
DSN3SI80, and/or DSN3CT80). 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30458 


Explanation: The DB2 subsystem is abended because the 
user-exit module DSN3@ATH is not tink-edited with the AMODE 
(31) attribute. 


—s 73 internal DB2 Information — eee = 2G | 


This abend reason code is issued by the following CSECT(s): 
DSNSAMI1 


(ee a End of Internal DB2 Information eee ees | 


System Action: Subsystem start-up is terminated. 


Operator Response: DB2 may be restarted after the link-edit 
attributes of DSN3@ATH have been changed to AMODE (31) 
RMODE (ANY). 


System Programmer Response: Link-edit the user-exit module, 
specifying the attributes AMODE (31) RMODE (ANY). 


Problem Determination: Refer to the JCL specifying link-edit 
attributes for the user exit module. Refer to “DB2 Abend Com- 
pletion Codes (X'04E' and X'04F)” on page 1-6 for information 
on X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 4. 


00F30459 


Explanation: The DB2 connection associated with an allied 
TCB could not be terminated. A RARQ request to terminate the 
connection could not be issued because either: 


¢ The Resource Access List (RAL) address was zero in field 
ACERAL, or 


¢ The SSAM Function Vector List (FVL) address in the RAL 
was zero. 


~~ {nternal DB2 Information are 


This abend reason code is issued by the following CSECT(s): 
DSN3TMO0 


ae End of Internal DB2 information eed 


System Action: The DB2 subsystem is terminated with a 
reason code of X'00F30420'. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for failure analysis procedures. 


Problem Determination: This is a DB2 internal error. Collect 
the following diagnostic items listed in Appendix B, “Problem 
Determination” on page X-5: 1, 2,5. 


00F30501 


Explanation: A nonzero return code has been received from 
the system parameter manager (SPM) subcomponent of DB2 
when attempting to read a descriptor from the DSN3DIR1 direc- 
tory. This descriptor is required in order to complete proc- 
essing of the active sign-on or create thread. This is a serious 
error. 


| Internal DB2 Information ~ : ~ | 


This abend reason code is issued by the following CSECT(s): 
DSN3CT30, DSN3SI130 


| eee ee End of Interna! DB2 Information eet 


System Action: The requester is abended, and the request is 
not processed. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: An SVC dump should be available. 
‘Either the module issuing the abend has made an error in com- 
pounding the descriptor name (it is a concatenation of con- 
nection type and indicators representing the request type) or 
the descriptor, or information in the DSN3DIR1 directory is 
incorrect. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30502 


Explanation: A nonzero return code was received from agent 
service's create allied agent function during an identify or 
sign-on request. This indicates an allocation error that should 
not occur for these levels of capability. 


| ~~ Internal DB2 Information a | 


._This abend reason. code is issued by the following CSECT(s): 
DSN3ID50, DSN3SI!30 


ee ae End of internal DB2 Information ete sl 


| 
| 


00F30501 — 00F30572 


System Action: . The requester is abended, and the request is 
not processed. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: An SVC dump and associated 
SYS1.LOGREC eniries should be available. Examine the DB2 
trace table to determine which resource manager triggered the 
error indication. Also, the DSN3DIR1 entry for the appropriate 
protocol should be checked to ensure that only SSAM is speci- 
fied to participate in allocation. 


Coliect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30503 


Explanation: The member DSN6SYSP is missing from 
DSNZPARM. 


| Internal DB2 Information fe ies ~ | 


This abend reason code is issued by the following CSECT(s): 
DSNS3AMI1 


an End of Internal DB2 Information een 


System Action: DB2 start-up is terminated. 


System Programmer Response: Refer to the coding procedure 
for DSNZPARM in Section 2 (Volume 1) of Administration Guide. 


Problem Determination: DSN6SYSP CSECT is missing from the 
DSNZPARM load module. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30571 


Expianation: This reason code is returned when a DB2 
program attempts to UNSPECIFY an already inactive Program 
Request Handler (PRH). The indicated PRH is inactive. This 
reason code merely provides extra information. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 


| ~~ Internal DB2 Information ~~ er 


This DB2 reason code is issued by the following CSECT(s): 
DSN3SPRX, DSN3SPRO 


Bees aha ae End of Internal DB2 information ee | 


System Action: None. The requested condition already 
existed. 


00F30572 


Explanation: This reason code is returned when a DB2 
program attempts to SPECIFY a Program Request Handler 
(PRH) and there was one already active. The new specification 
overlays the older specification. 


This reason code is not normally visible to users or operators, 
but may appear in DB2 traces. 
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00F30573 — 00F30597 


| internal DB2 Information 


This DB2 reason code is issued by the following CSECT(s): 
DSN3SPRX,DSN3SPRO 


Loe weet ae End of Internal DB2 Information es 


System Action: The new specification replaces the old one. 


00F30573 


Explanation: The invoker of DSN3SPRH specified an invalid 
value for a resource access list entry (RALE). The RALE is 
outside the limits of those supported by the application program 
support CALL routine. (The application program support CALL 
routine routes control to the program request handlers.) 


| Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN3SPRO, DSN3SSPRX 


as End of Internal DB2 Information | 


System Action: The requester is abended, and the request is 
not processed. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Probiem Determination: An SVC dump and associated 
SYS1.LOGREC entries are produced by a DB2 service. Register 
2 at the entry to the abend contains the resource access list 
element (RALE) value passed. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30574 


Explanation: The invoker of DSN3SPRH specified an invalid 
request qualifier (QUAL) value. The QUAL is outside the limits 
of those supported by the application program support call 
routine that routes control to the program request handlers 
(PRHs). 


ha cons goa Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SPRO, DSNS3SSPRX 


| End of internal DB2 Information ___——_| 


System Action: The requester is abended, and the request is 
not processed. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: An SVC dump and SYS1.LOGREC 
entry are produced by a DB2 resource manager. Register 2 at 
the entry to the abend contains the QUAL value passed. 
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Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30580 


Explanation: The DSN3CONN request for the EOM, first EOT or 
identify SSI call during the 'release-work' notification has 
resulted in a nonzero return code (see message DSN3580I). 


| — Internal DB2 Information 0 p> ge | 


This abend reason code is issued by the following CSECT(s): 
DSN3AMI2 


———— End of internal DB2 Information | 


System Action: The requester is abended. 
Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The original return and reason code 
appear in the DSN3580! message issued by DSN3AMI2. An SVC 
dump and associated SYS1.LOGREC entries are produced by 
some DB2 resource manager. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30581 


Explanation: CSECT DSN3AMI2 found an unknown type of 
notify message in a message buffer. This is a DB2 subsystem 
error. 


ee <— ~ Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3SAMI2 


eee teen End of Internal DB2 Information ere 


System Action: An abend is issued, and the startup/shutdown 
ESTAE creates a SYS1.LOGREC entry and take an SVC dump. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Examine the SYS1.LOGREC 
entries and SVC dumps. Refer to Section 5 of Diagnosis Guide 
and Reference for failure analysis procedures and for informa- 
tion about dump analysis and service aids. 


Problem Determination: The SVC dump that is produced con- 
tains the relevant material for problem analysis. These buffers 
are set up by DSN3CLO00 or DSNSCLOX. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30597 


Explanation: A protocol violation has been detected for an 
identify request. A noncoordinator identify request has been 
requested from a task that is not a subtask of the active coordi- 
nator. This occurs for protocols only where TCB hierarchy must 
be observed (SASS) and. only when a coordinator has already 
identified itself to DB2. 


| : Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3ID30 


tee oo End of internal DB2 Information pos feed Poo | 


System Action: The allied task is abended, and the request is 
not processed. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: An SVC dump may be produced by the 
allied address space. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30598 


Explanation: A protocol! violation has been detected for an 
identify request. A noncoordinator identify request has been 
requested in a PSW key different from KEY of the active coordi- 
nator at its identify. This occurs only when a coordinator has 
already identified itself to DB2. 


[peso re Internal DB2 Information ~ | 


This abend reason code is issued by the following CSECT(s): 
DSN3ID30 


Reseoateeat End of Internal DB2 Information ere | 


System Action: The allied task is abended, and the request is 
not processed. 


Operator Response: Notify the system programmer. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: An SVC dump may be produced by the 
allied address space. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5:. 1, 2, 5. 


00F30599 


Explanation: The allied memory function of the subsystem 
support subcomponent (SSAM) has attempted to remove an 
AGNT block (representing a connected allied coordinator task) 
from the chain of active AGNT blocks before all the dependent 
AGNT blocks have been removed. This AGNT block would 
normally be removed only during SSAM terminate processing 
or during EOT processing for the coordinator task. However, in 
these cases, dependents are terminated bottom up, and this sit- 
uation, if it occurs, is a serious one. This message probably 
represents a logic error in the subsystem support 
subcomponent’s allied memory function (SSAM). 


00F30598 — 00F30801 


| == internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN3UNCH 


End of Internal DB2 Information ee re | 


System Action: The requesting SSAM module is abended. The 
connection name associated with the error is probably unable 
to continue communication with DB2 until DB2 is terminated 
and restarted. 


Operator Response: Notify the system programmer. If neces- 
sary, stop and restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The SVC dump and associated 
SYS1.LOGREC entries contain the relevant material for problem 
analysis. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30610 


Explanation: CSECT DSN3AMTS could not establish an ESTAE 
during the processing of an 'end stop-work force' notification. 
This can occur if the current address space (usually system 
services) has insufficient storage. This may lead to abnormal 
termination of DB2. 


fs Internal DB2 Information ~ a | 


This abend reason code is issued by the following CSECT(s): 
DSN3AMT3 


eet End of Internal DB2 Information eet | 


System Action: The caller is abended (without ABDUMP).. 


Operator Response: Notify the system programmer and, if nec- 
essary, restart DB2. 


System Programmer Response: If necessary, increase the 
private area size of the failing address space. 


Problem Determination: An SVC dump and related 
SYS1.LOGREC entry are requested by the initialization proce- 
dures (IP) subcomponent job-step task. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30801 


Explanation: The DB2 subsystem was abended by module 
DSNAPRHO or DSNAPRHX. DSNAPRHO or DSNAPRHX was 
called and the request was passed on to the DB2 subsystem. 
However, upon reiurn, it was discovered that the requesting 
(calling) TCB was in a DB2 must-complete function or was still 
holding DB2 latches. 
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00F30802 — 00F33100 


” Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


tent ee ee End of Internal DB2 Information eee 


System Action: The DB2 subsystem is terminated. An MVS 
SVC dump is requested. 


Operator Response: Notify the system programmer, and 
restart DB2. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: This is usually caused by a previous 
error that has created SYS1.LOGREC entries and requested an 
SVC dump. The SYS1.LOGREC entries and SVC dumps should 
be examined to determine the actual cause of the error. Refer 
to “DB2 Abend Completion Codes (X'04E' and X'04F)” on 
page 1-6 for information on X'04F' and X'04E' abend com- 
pletion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30802 


Explanation: CSECT DSNAPRHO or DSNAPRHX, on the return 
path (normal nonerror path) from the requested function, found 
that the FRBUDATA flag was on. This is a DB2 subsystem error. 


aa Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


eer End of Internal DB2 Information ere | 


System Action: The requesting task gets the FRB return and 
reason codes as set by the requested function. The task is not 
abended. 


System Programmer Response: Refer to Section 5 of Diag- 
nosis Guide and Reference for information about what diag- 
nostic materials to gather, for failure analysis procedures, and 
for information about dump analysis and service aids. 


Problem Determination: The SYS1.LOGREC entries and SVC 
dump should be examined to determine the actual cause of the 
error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


OOF30802 

Explanation: CSECT DSNAPRHO could not establish its ESTAE 
during the processing of an application program support call. 
This can occur if the current address space has insufficient 
storage. 
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internal DB2 Information - | 


This abend reason code is issued by the following CSECT(s): 
DSNAPRHO 


| Ss End of Internal DB2 Information ___——_—| 


System Action: The allied task is abended (without ABDUMP). 
Operator Response: Notify the system programmer. 


System Programmer Response: The user may retry the 
request. If necessary, increase the private area size of the 
application address space. 


Problem Determination: The allied task may have requested 
an SVC dump. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F30805 


Explanation: The caller’s connection with DB2 has been termi- 
nated, because the DB2 subsystem has terminated or is in the 
process of terminating abnormally. 


| a — Internal DB2 Information ~ “| 


This abend reason code is issued by the following CSECT(s): 
DSNAPRHO, DSNAPRHX 


{| End of Internal DB2 Information epee 


System Action: The request may have been processed or 
aborted. 


User Response: The requester may identify to DB2 when it 
becomes operational again. 


Problem Determination: Refer to “DB2 Abend Completion 
Codes (X'04E' and X'04F)” on page 1-6 for information on 
X'04F' and X'04E' abend completion codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 5. 


00F33100 
Explanation: The DB2 thread is 'read-only'. 


| Internal DB2 Information 


This reason code is issued by the following CSECT(s): 
DSN3PROO 


Ls End of internal DB2 Information ____| 


System Action: A prepare issued by the application program 
was processed through Phase 1. DB2 discovered there were no 
resources modified and no need for commit or abort to be sub- 
sequently issued. 


User Response: May effect a path length savings by not 
issuing the subsequent commit or abort which normally follows 
prepare. No further action is required to complete the unit of 
recovery; the unit of recovery is complete. 


OOFSAFFF 


Explanation: An unrecoverable error return code was received 
from the RACROUTE REQUEST =VERIFY macro service. The 
return code was other than 0, 4, 12, 20, 24, 28, 36, 48, or 52. 


[ Internal DB2 Information Set es | 


This abend reason code is issued by the following CSECT(s): 
DSN32SGN 


Pho End of Internal DB2 Information pice Se 2 


System Action: The SIGNON request is abended. An SVC 
dump is requested by DB2 functional recovery. 


User Response: Notify the system programmer. 


Operator Response: Notify the system programmer. 


OOF3AFFF — OOF3AFFF 


System Programmer Response: Collect the diagnostics listed 
below. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Problem Determination: The abend with this reason code is 
issued by the sample SIGNON exit after the implementation in 
the user’s installation. tt indicates that an unrecoverable error 
occurred with the RACROUTE REQUEST = VERIFY macro 
service. 


GPR 2 at the time of abend will contain the original RACROUTE 
return code from GPR 15. GPR 3 at the time of abend will 
contain the reason code returned by the RACROUTE macro 
service in GPR 0, if any. 


Refer to System Programming Library: Resource Access 
Control Facility (RACF) for descriptions of the RACROUTE 
return and reason codes. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 
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General 


Command Processor Codes (X'F9') 


Recording in the SYS1.LOGREC data set is 
requested for all of the following abnormal termi- 
nation conditions. The SDWA variable recording 
area (VRA) contains the information provided by 
the DSNWRCRD function. When VRA space 
permits, the recordable section of the diagnostic 
data table (DDT control block) is also placed in the 
VRA. The DDT, which contains recovery tracking 
and diagnostic information, is described in Section 
7 of Diagnosis Guide and Reference. For informa- 
tion about finding the SDWA, refer to Section 5 of 
Diagnosis Guide and Reference. 


All general command processor modules use reg- 
ister 10 as a base register. This may be helpful 
when attempting to match a register value to a 
module map. 


00F90000 


Explanation: A command processor has been invoked via the 
application program support function while the local lock of the 
caller’s address space was held. CSECT DSN9SCMF tried to 
obtain the lock in order to obtain a response message buffer, 
but it was unable to do so. This represents a logic error in the 
function that submitted the command to the application program 
support function. 


| Internal DB2:Information = <s ‘| 


This abend reason code is issued by the following CSECT(s): 
DSNSSCNF 


Reeeese = oP End of Internal DB2 Information et ets 


System Action: Command execution was abended. If the 
command was properly entered, it may have been partially or 
completely executed. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. It may be 
necessary to restart the attachment (IMS/VS or CICS). 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General”. 


00F90000 — 00F90002 


00F90001 


Explanation: A command processor has been invoked via the 
application program support function. CSECT DSN9SCNF 
obtained the LOCAL lock of the caller’s address space prior to 
obtaining a response message buffer, but was then unable to 
release the lock. This condition, if it occurs, is a serious one. 


[ Internal DB2 Information ares <7 


This abend reason code is issued by the following CSECT(s): 
DSN9OSCNF 


es End of Internal DB2 Information ene 


System Action: Command execution was abended. If the 
command was properly entered, it may have been partially or 
completely executed. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. It may be 
necessary to restart the attachment (IMS/VS or CICS). 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General”. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00FS0002 


Explanation: The routines of the multiple console support 
(MCS) service of MVS were unable to initialize. CSECT 
DSN9SCNM attempted to create the console task controller 
service task, but the task was not successfully created. This 
condition may indicate a problem in the &dscf. address space. 
If it occurs, this is a serious error. 


js Internal DB2 Information _ | 


This abend reason code is issued by the following CSECT(s): 
DSN9SSCNM 


Dice End of Internal DB2 Information ae ee 


System Action: Subsystem initialization is aborted, causing the 
DB2 subsystem to terminate. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. Restart the 
DB2 subsystem. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference: 
for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General”. 
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00F90003 — 00F90006 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F 90003 


Explanation: The routines of the multiple console support 
(MCS) service of MVS were unable to initialize. CSECT 
DSN9SCNM or DSN9SCNE attempted to create a console 
service task but the task was not successfully created. This 
condition, if it occurs, is a serious one. 


f= T= Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSN9SCN6, DSN9SCNM 


[| End of internal DB2 Information ____| 


System Action: Ifthe abend was issued by CSECT DSN9SCNM, 
DB2 subsystem initialization is aborted, causing the DB2 sub- 
system to terminate. if the abend was issued by CSECT 
DSNSSCN6, the command from the associated console is exe- 
cuted under a different service task and should proceed 
normally. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F90004 


Explanation: The routines of the multiple console support 
(MCS) service of MVS detected a logic error. CSECT 
DSN9SCN7 received a return code from the command pre- 
processor (the DSN9CMD service) that indicated an intolerable 
condition. A return code of X'04' is issued if the DSNSCMD 
calling parameters are invalid (the command text length is not a 
positive number or the PHB address is zero). 


A return code of X'24' is provided if storage for a tokenized 
command statement (TCS) cannot be obtained from the global 
storage pool obtained by CSECT DSNOSCNP. The TCS storage 
request is the first storage request made using this pool. This 
is not a user error. 


[ Internal DB2 Information — | 


This abend reason code is issued by the following CSECT(s): 
DSN9SCN7 


ee ae oe End of Internal DB2 Information a eee 


System Action: The command was not executed. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 
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for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F90005 


Explanation: A routine of the multiple console support (MCS) 
service of MVS was not able to create an ESTAE recovery envi- 
ronment. This condition is detected when the ESTAE service of 
MVS returns a nonzero return code. The command from the 
associated MCS console is not executed. Refer to the appro- 
priate MVS publication for an explanation of ESTAE return 
codes. 


| 7 ~~ Internal DB2 Information ~~~ ——4 


This abend reason code is issued by the following CSECT(s): 
DSN9SCN7, DSNOSCN6 


Wpeees eee End of Internal DB2 Information cease oes | 


System Action: Command processing is terminated. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


OOF 90006 


Explanation: The agent allocation routine was not able to allo- 
cate command processing capability to an agent. This failure 
occurs, because there is a damaged control block in global 
storage (CSA). The contro! block is the command global! data 
area (CGDA). The address of the CGDA is in the general 
command processor RMFTRUSE field. This is not a user error. 


= “~~~ _ internal DB2 Information ~~ _ 7 =| 


This abend reason code is issued by the following CSECT(s): 
DSNSSCNB 


ee End of Internal DB2 Information ee ee 


System Action: Agent allocation is terminated. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. It may be 
necessary to restart the attachment (IMS/VS or CICS) or the 
DB2 subsystem. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 


for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F90007 


Explanation: The command parsing routines have attempted to 
update one of the command statistical counters that are kept in 
&dscf. local storage. However, the counter control block vali- 
dation field is wrong, indicating a damaged control block. The 
counter control block is located via the 'CGDASTA' address in 
the command globa! data area (CGDA) control block. The 
CGDA address is in the general command processor 
RMFTRUSE field. This is not a user error. 


[ = —— Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSN9SCN2 


(es End of Internal DB2 Information nee 


System Action: The statistical update is not completed. The 
statistics block address is cleared from the CGDA to prevent 
future failures. No further command statistical counts are main- 
tained. Processing for the command is retried and should com- 
plete normally. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. if a dump was produced, have it printed. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F90008 


Explanation: The recovery manager control routine has been 
called, but register 6 did not contain the address of an exe- 
cution block (EB) on entry to DSN9SCN9. Because recovery 
logic requires the address of the EB, CSECT DSN9SCN9 cannot 
’ proceed. The EB hexadecimal control block identifier and the 
block length are compared to known values in order to validate 
the EB address. This is not a user error. 


00F90007 — O0F9000A 


Internal DB2 Information 


This abend reason code is issued by the following CSECT(s): 
DSNSSCN9 


Wise pee End of internal DB2 Information fate 222] 


System Action: The function requesting the recovery manage- 
ment service is abended. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. It may be 
necessary to restart the attachment (IMS/VS or CICS) or the 
DB2 subsystem. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F90009 


Explanation: This reason code is used to document that CSECT 
DSN9SCN¢9 has added information to the SDWA variable 
recording area (VRA) following the data provided by the 
DSNWRCRD service. !f DSN9SCNS records a failure in 
SYS1.LOGREC and the reason code in the VRA is not of the 
form X'OOF9xxxx', the reason code is changed to X'00F90009'. 
This is done so that anyone examining a SYS1.LOGREC entry 
can determine, from the reason code, what additional data has 
been placed in the VRA. The reason code is the first data item 
in the VRA, as mapped by macro IHAVRA. 


| Internal DB2 Information | 


This abend reason code is issued by the following CSECT(s): 
DSNSSCNQ 


a End of Internal DB2 Information pee! 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Probiem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


OOFS000A 


Explanation: The command parsing routines attempted to 
obtain a descriptor using the DSNZGDE service of the system 
parameter manager but the expected descriptor was not found 
(the DSNZGDE return code was X'04'). All descriptors used by 
the parser are contained in CSECT DSNSSCNA. This failure 
probably indicates incorrect data in CSECT DSN9OSCNA. 
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OOF9000B — OOFS000C 


| Internal DB2 Information ~———— 2% 


This abend reason code is issued by the following CSECT(s): 
DSN9OSCN4, DSNOSCN2, DSN9SCN1 


| End of Internal DB2 Information _______| 


System Action: Command execution was abended. The 
command was not executed. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. It may be 
necessary to restart the attachment (IMS/VS or CICS) or the 
DB2 subsystem. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the SDWA variable recording area (VRA). For 
additional diagnostic information, see “General” on 

page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


00F9000B 


Explanation: The command parsing routines attempted to 
obtain storage from the storage pool (PHB) provided ona 
DSN9SCAN service request. Normally, this is CSA storage in 
the pool built by CSECT DSN9SCNP. The storage request could 
not be satisfied, either because no CSA storage was available 
or because an unreasonably large amount of storage was 
requested. The amount of storage requested is determined by 
the length of the command being parsed. Normally, it is 
several hundred bytes. 


| Internal DB2 Information iam 


This abend reason code is issued by the following CSECT(s): 
DSNSSCNO 


Weta ee End of internal DB2 Information ers 


System Action: Command execution is abended. 


Operator Response: Print the contents of the SYS1.LOGREC 
data set. If a dump was produced, have it printed. It may be 
necessary to restart the attachment facility (IMS/VS or CICS) or 
the DB2 subsystem. 


System Programmer Response: Determine the failing environ- 
ment, and refer to Section 5 of Diagnosis Guide and Reference 

for failure analysis procedures and for information about dump 
analysis and service aids. 


Problem Determination: The diagnostic data table (DDT control 
block) appears in the subsystem diagnostic work area (SDWA) 
variable recording area (VRA). Register 8 contains the address 
of the tokenized command statement (TCS) contro! block, and 
register 9 contains the requested storage length. The TCS is 
the DB2 internal representation of the command text. For addi- 
tional diagnostic information, see “General” on page 4-285. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 
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O0oFS000C 


Explanation: The command preprocessor (GCPC) mainline 
routine (DSN9SCNP) encountered a validation error when 
examining the message chains returned from the command 
processor. 


The command processor invoked attempted to return a 
message formatted for inclusion in an MVS Multiple Line WTO. 


| Internal OB2 Information Pe | 


This abend reason code is issued by the following CSECT(s): 
DSN9SCN9 


bees ees End of Internal DB2 Information ee etl 


System Action: Command execution is abended. 
User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: This error reflects a failure 
identified during DB2 internal protocol verification. The 
command in error is identified by message DSN9017!. Register 
8 points to the start of the response message chain returned by 
the command processor. Register 9 points to the message 
within the message chain that was found to be in error. 


Refer to Section 5 of Diagnosis Guide and Reference for failure 
analysis procedures. 


Probiem Determination: The GCPC Diagnostic Data Table 
(DSNDDDT Control Block) is recorded in the Variable Recording 
Area of the SDWA associated with the error. 


Collect the following diagnostic items listed in Appendix B, 
“Problem Determination” on page X-5: 1, 2, 5. 


Section 5. IRLM Messages and Codes 


IRLM Messages and Codes 5-1 





introduction 


This section describes messages for the IMS/VS 
resource lock manager (IRLM) subcomponent. 
The purpose of the IRLM subcomponent is to 
control resource sharing between multiple IMS/VS 
subsystems executing within one or two MVS 
systems and to provide locking services for the 
IBM DATABASE 2 (DB2) licensed program. 


IRLM messages have a prefix of DXR. The mes- 
sages are presented in numeric order and have 
the form of DXRXXXA, where the letter 'A' repres- 
ents a coded suffix. The meaning of the suffix 


varies depending upon the content of the message. 


If the suffix A, /, or E is used, the following applies: 
A means that action is required of the user before 
processing can continue, / means that the 
message is for information only, and E means that 
the message is an error condition which may 
require action. 


A message-to-module cross-reference appears in 
IMS/VS Diagnosis Guide. 


All DXR messages contain the 4-character MVS 
subsystem name of the IRLM that issued the 
message. 


In the following message descriptions, 'irlm' des- 
ignates the MVS subsystem name assigned to 
IRLM. 


For each message, the following accompanying 
information is provided when applicable: 


Explanation: What the message means; why it 
appears; what caused it; what its variable entry 
fields are. 


System Action: What is happening as a result of 
the condition causing the message; whether the 
system is waiting for responses. 


System Programmer and/or Operator Response: If 
a response is necessary, who performs it; what 
are the pertinent responses, and what are their 
effects on the system or application program. If 
this section is not shown, it does not apply. 


Problem Determination: If the problem recurs or is 
persistent to the point that system efficiency 
suffers, what actions can be performed to obtain 
adequate data for trained hardware or program- 
ming support personnel to diagnose the problem. 
These actions do not teach diagnostic techniques, 
but instruct the operator or system programmer 
what to do when problems recur. The problem 
determination actions are aids to the identification 
of hardware and programming problems and 
ensure that qualified support personne! will have 
the necessary programming information to diag- 
nose and correct the difficulty. If this section is not 
shown, it does not apply. 
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DXR Messages 


DXRO011 irim STATUS SCOPE = nnnnnn 
SUBSYSTEMS IDENTIFIED TO 
x [(y) (z (a))] PTm: 
NAME STATUS UNITS HELD WAITING 
ssname zzz wun ren rew 
ssname 2Zzz wun siren rew 


Explanation: This message is issued in response to the 
command F irlmproc,STATUS. 


Note: Ifthe IRLM is started with the SCOPE =LOCAL 
command, this also responds to the F irlmproc,STATUS,y since 
y is ignored. 


For SCOPE =LOCAL: 


x The MVS name of irlm followed by the IRLMID. The 
text within brackets is not present. 


For SCOPE= GLOBAL: 
For SCOPE =LOCAL: 


x The VTAM name of irlm. 

y The IRLMID of irlm. 

z The VTAM name of the other IRLM. 

a The IRLMID of the other IRLM. If the IRLMID is 


unknown, a '?' appears in this field. A '?' would 
appear, for example, if the |RLMs were not connected 
and had not previously been connected. 


The variables m, ssname, zzz, wun, ren, and rew are defined 
below. 


Variable Meaning 


m A decimal number 1, 2, etc. Where more than 10 
lines are required in response to a status 
command, multiple messages are issued, with m 
increased by one in each successive message. 


ssname An 8-character IMS/VS subsystem name. 


ZzZ A value of UP indicates that the IMS/VS subsystem 
is active. A value of DOWN indicates that the 
IMS/VS subsystem is not active. A value of 
'UP-RO' indicates that the IMS/VS subsystem is 
active and is currently identified to the IRLM as a 
read-only subsystem. A value of CLEANUP indi- 
cates that the IRLM is waiting for the IMS/VS sub- 
system to respond with a PURGE when the cleanup 
is complete. An IMS/VS subsystem should not 
remain in cleanup status for an extended period of 
time. As long as one IMS/VS subsystem remains in 
cleanup mode, no other IMS/VS subsystem will 
issue new lock requests to the IRLM. If one IMS/VS 
subsystem remains in cleanup mode for an 
extended period of time, it should be canceled to 
permit other IMS/VS subsystems to resume normal 
operations. 


wun The number of work units under the IMS/VS sub- 
system that are holding or waiting for a lock. No 
work units exist for an inactive IMS/VS subsystem. 
In this case, the field is set to '...'. 


DXROOTI — DXROO3A 


ren The number of resources locked. 


rew The number of waiting lock requests. No waiting 
requests are permitted for an inactive IMS/VS sub- 
system. In this case, the field is set to '...'. 


lf no IMS/VS subsystems are identified to this IRLM, the line 
beginning with 'ssname' is replaced with 'NO INFORMATION 
AVAILABLE’. 


System Action: Processing continues normally. 


DXRO002I irlm x VTAM SESSION WITH y 


REQUESTED|ESTABLISHED 


Expianation: irim has either requested or established a VTAM 
session with its partner IRLM. 


The x value is the VTAM application name of the IRLM issuing 
the message. The y value is the VTAM application name of the 
other IRLM. 


ESTABLISHED Indicates a session with another IRLM has 
been established. 
REQUESTED A VTAM session has been requested 


during IRLM initialization or at ACTCOMM 
command time. 


This message indicates that the IRLM has successfully opened 
the VTAM interface. 'REQUESTED' means that the other IRLM 
has not been started or is in the process of being initialized. 
When the other IRLM is active, the connect sequence occurs 
automatically. 


System Action: Processing continues normally. 


Operator Response: If the message indicates ‘REQUESTED', 
and it has not already started, start the other IRLM. 


DXRO03A irim x VTAM DEF/OPERATION PROBLEM OPEN 


y|SIMLG zz A|RQSES zz a 


Explanation: An exception condition has been returned by a 
VTAM operation, indicating a probable error in the VTAM defi- 
nition of the IRLM or VTAM operations. To correct the problem, 
assistance is required by the system programmer or operator. 


The meaning of values x, y, z z, and a are: 


Value Meaning 

x The VTAM application name of the IRLM issuing the 
message. 

y if the failure is on the OPEN macro, y is the contents 
of ACBERFLG. 

Zz For SIMLOGON or REQSESS, z z is the RTNCD and 
FEEDBACK provided by VTAM. 

a For SIMLOGON or REQSESS, the VTAM name of the 


other IRLM being connected. 


System Action: The IRLM has closed the VTAM ACB and con- 
tinues the operation in the global sharing state that existed 
before the error was detected. No further attempt to establish a 
session will be made until a MODIFY command with the 
ACTCOMM parameter is received. When ACTCOMM is 
received, IRLM wil! attempt to reestablish the VTAM session. 


Operator Response: Notify the system programmer. 
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DXRO0041 — DXRO004I 


System Programmer Response: Determine from Advanced 
Communications Function for VTAM, Programming and 
ACF/VTAM Version 3 Messages and Codes the meaning of the 
error status displayed in the message. If the problem is correc- 
table, correct it and issue a MODIFY command with the 
ACTCOMM parameter to the IRLM. The IRLM VTAM definitions 
may be deactivated, modified, and reactivated if necessary. 
Explanations for specific situations that may be encountered 
are: 


OPEN ACB ERRORS (ACBERFLG) 
Error Description 
x'14!' There is a temporary storage shortage. 


ACTION: Issue a MODIFY command with the 
ACTCOMM parameter to the IRLM. 


X'24' Password is missing 


ACTION: Verify that the IRLM VTAM application 
statement does not specify a password. 


X'52' ACF/VTAM is halting. 


ACTION: After VTAM is started again, issue a 
MODIFY command with the ACTCOMM parameter to 
the IRLM. 


X'54! The IRLM name is not defined in the VTAM tables. 


ACTION: Verify that there is a VTAM application 
statement for this IRLM and that the APPLS param- 
eter on the IRLM start procedure specifies the 
correct VTAM names of the IRLMs. 


X'56' An IRLM name was found in the VTAM tables which 
was not the name of an application program. 


ACTION: Correct the definition. The IRLM must be 
defined as a VTAM application via the APPL state- 


ment. 
X'5A' Refer to the description and action for X'54'. 
X'5C' ACF/VTAM is not started. 


ACTION: Start VTAM and verify that the IRLM VTAM 
definition is active, then issue a MODIFY command 
with an ACTCOMM parameter to the IRLM. 


SIMLOGON, REQSESS ERRORS 


Error Description 

REQSESS RTNCD = X'14' FDBK2 = X'4B' 

SIMLOGON RTNCD = X'14' FDBK2 = X'4B' 
VTAM cannot find the IRLM LOGMODE 
entry. Verify that the MODETAB and 
DLOGMOD parameters on the VTAM APPL 
statement which defines the IRLM are 
coded correctly. When the definition is cor- 
rected, issue F irlmproc,AACTCOMM. 

SIMLOGON RTNCD = X'14' FDBK2 = X'53' 

REQSESS RTNCD = X'14' FDBK2 = X'53' 


The other IRLM is not known to VTAM. 
Either no VTAM definition exists (perhaps 
the APPLS parameter was specified incor- 
rectly), or the IRLM definition is not active 
to VTAM. If no VTAM definition exists, ter- 
minate the IRLM. If the IRLM definition is 
not active, activate the definition and issue 
F irlmproc,ACTCOMM. 
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SIMLOGON RTNCD = X'14' FDBK2 = X'55' 


This message is for SIMLOGON only. The 
IRLM is not authorized to issue SIMLOGON. 
Verify that the VTAM APPL statement that 
defines the IRLM specifies AUTH = (ACQ). 
Verify that no VTAM user exit is denying the 
acquire authority to the IRLM. When the 
problem is corrected, issue F 
irlmproc,ACTCOMM. 


DXRO0041 irlm zzzzz 


Explanation: A message is sent in response to one of the fol- 
lowing commands: 


'F irlmproc,START,PTBTRACE ' 
'F irlmproc,START,TRACE ' 

'F irlmproc,START,ITRACE' 

'F irtmproc,START,GTRACE ' 
'F irlmproc,STOP,TRACE' 

'F irlmproc,STOP,ITRACE' 

'F irlmproc,STOP,GTRACE' 

'F irlmproc,STOP,PTBTRACE' 


The zzzzz value is replaced with one of the following: 


TRACE STARTED 
Indicates an IRLM internal trace and IRLM GTF 
traces are started. 


ITRACE STARTED 
Indicates an IRLM internal trace is started. 


GTRACE STARTED 
Indicated the IRLM Request handier GTF trace is 
started. 


PTBTRACE STARTED 
indicates an IRLM PTB GTF trace is started. 


TRACE ALREADY STARTED 
Indicates an IRLM internal and GTF traces have pre- 
viously been started and not stopped. If global, 
IRLM PTB GTF trace is also started. 


GTRACE ALREADY STARTED. 
Indicates the IRLM Request handler GTF trace has 
previously been started and not stopped. 


PTBTRACE ALREADY STARTED 
indicates an IRLM PTB GTF trace is already started. 


TRACE STOPPED 
Indicates IRLM internal GTF traces are stopped. 


ITRACE STOPPED 
Indicates IRLM internal trace is stopped. 


GTRACE STOPPED 
Indicates the IRLM Request handler GTF trace is 
stopped. 


PTBRRACE STOPPED 
Indicates the IRLM PTB GTF trace is stopped. 


TRACE ALREADY STOPPED 
Indicates IRLM internal and/or GRF traces have not 
been started. If global, IRLM PTB GTF trace is also 
stopped. 


PTBTRACE ALREADY STOPPED 
Indicates IRLM PTB GTF trace has not been started. 


ITRACE ALREADY STOPPED 
Indicates IRLM internal trace has not been started. 


GTRACE ALREADY STOPPED 
Indicates the IRLM Request handler GTF trace has 
not been started. 


System Action: Processing continues normally. IRLM internal 
and GTF trace activity is as indicated. 


DXROO05E irlm TRACE WARNING - GTF USR OPTION NOT 


ACTIVE 


Explanation: The IRLM tracing is active, but the GTF facility is 
not active or the GTF facility was not started with the USR 
option. The IRLM event records are lost. 


System Action: Processing continues normally. IRLM trace 
remains active and invokes the GTF to trace the event records. 


Operator Response: Start or restart the GTF facility with the 
USR option, or stop IRLM tracing. 


DXROOGE irim STOP COMMAND REJECTED, STILL ACTIVE 


Explanation: An irim STOP command was entered, but was 
rejected because the IRLM still had active subsystems identi- 
fied. 


System Action: Processing continues normally. 


Operator Response: Reenter the STOP command after all 
active subsystems have terminated, or terminate the IRLM 
abnormally with the 'F irlmproc,ABEND' command. 


DXROO7E irlm x VTAM OPEN ERROR ACBERFLG=y 


Explanation: The VTAM OPEN performed, during the process 
of attempting to establish a global sharing environment, failed. 
y is the value of ACBERFLG. The value of x is the VTAM appli- 
cation name of the IRLM issuing the message, that is, the name 
used to OPEN ACB to VTAM. 


See the description of the OPEN macro in Advanced Communi- 
cations Function for VTAM, Programming for a description of 
the y values. ACF/VTAM Version 3 Messages and Codes pro- 
vides additionai information. 


System Action: IRLM terminates with abend U2021. 
Operator Response: Notify the system programmer. 


System Programmer Response: Determine the meaning of the 
error field (ACBERFLG) under the OPEN function description in 
Advanced Communication Function for VTAM, Programming. 
ACFIVTAM Version 3 Messages and Codes also provides infor- 
mation. 


Problem Determination: Message DXR021E should appear 
sometime after this message, and associated with it should be 
an abend and an SDUMP. Refer to the problem determination 
for message DXRO21E. 


DXROO8E irlm INITIALIZATION FAILED CODE = xx 


DETECTED BY zzzzzzzz 


Explanation: The IRLM was unable to complete initialization 
because of error, code 'xx'. 


The values of xx are: 


Code Meaning 

(Dec) 

01 _ Unable to allocate global storage. 

02 Unable to allocate focal storage. 

03 IRLMID was not specified, or was invalid. IRLMID 


must be specified as a 1-digit number using a value 
of 1 through 8. 


DXROO5E — DXROO8E 


04 GLOBAL was specified, and the COMCYL parameter 
was missing or invalid. COMCYL must be specified 
as a 2- to 6-digit number using a value of 10 through 


999999. 

05 A DEADLOK parameter was missing or invalid. This 
parameter must be specified as 'iiii,kkkk' ‘iiii' and 
‘kkkk' are 1- to 4-digit numbers of value 1 through 
9999. 

06 An MVS subsystem SSCVT containing the name 
specified by the IRLMNM parameter does not exist. 

07 Error in module zzzzzzzz initialization. 

08 Error loading IRLM modules. 

09 IRLM already started. 

10 SCOPE parameter is missing or invalid. Either 


LOCAL or GLOBAL must be specified. 


11 The MAXCSA parameter is missing or invalid. This 
parameter must be specified as a 1- or 2-digit 
number with a value of 1 to 99. 


12 The IRLMNM parameter is missing, or a value with a 
greater length than 4 was specified. 

13 The SETDIE for initial deadlock time interval failed. 

14 The PC parameter is missing or invalid. This 
parameter must be specified as either YES or NO. 

15 The PC parameter was specified as YES, but the 
MVS operating system does not support cross- 
memory. 

16 The ITRACE parameter is missing or invalid. This 


parameter must be specified as either YES or NO. 


17 The APPLS parameter is incorrect; either the 
second subparameter is missing or the subparam- 
eter has a length greater than 8. 


18 The RULES parameter is incorrect. Either COMPAT 
or AVAIL must be specified. 


The zzzzzzzz value is the name of the module that detected the 
failure. 


System Action: Abend 2018 is issued. An MVS dump for codes 
01, 02, 06, 07, 08, and 13 is taken. The IRLM has discontinued 
its initialization processing. 


System Programmer Response: 


Code Action 

(Dec) 

01 Make the global storage available to IRLM, and 
analyze the dump for more information. 

02 Increase the region size on IRLM procedure and 
analyze the dump for more information. 

03 Correct IRLM procedure IRLMID parameter. 

04 Correct IRLM procedure COMCYCL parameter. 

05 Correct IRLM procedure DEADLOK parameter. 

06 Verify that the IRLM procedure specifies the desired 


IRLM name. If IRLMNM specifies the desired name, 
verify that an MVS subsystem with that name is 


defined. 

07 Analyze the dump to determine problem. 

08 Analyze the dump to determine problem. 

09 Verify that the IRLM procedure specifies the-desired . 
IRLM name. 
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DXROO09!I — DXRO0111 


10 Correct the IRLM procedure SCOPE parameter. 
11 Correct the IRLM procedure MAXCSA parameter. 
12 Correct the IRLM procedure IRLMNM parameter. 
13 Analyze the dump to determine the problem. 

14 Correct the IRLM procedure PC parameter. 

15 Upgrade MVS operating system to at least SP1.3. 
16 Correct the IRLM procedure ITRACE parameter. 
17 Correct the IRLM procedure APPLS parameter. 
18 Correct the 1RLM procedure RULES parameter. 


Operator Response: Notify the system programmer. 
Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

¢ The IRLM address space dump generated at the time of 
failure 

¢ A listing of the [RLM start procedure JCL 

* A listing of the IMSGEN performed to install! the IRLM 

© Listings of the VTAM definitions performed to install the 
IRLM 


DXROOS9I irlm INITIALIZATION COMPLETE 


Explanation: The IRLM has successfully completed initializa- 
tion and is available for use. 


System Action: Processing continues normally. 


DXRO10! irlm STATUS SCOPE = GLOBAL 

SUBSYSTEMS IDENTIFIED TO 

x (y) (z (a)) PTm: 

NAME STATUS NAME STATUSssname 2zz 


ssname Z2z 


ssname 2zzZ +ssname 8 2z2zz 
Explanation: This message is issued in response to one of the 
following commands: 


F irlmproc,STATUS,irlmy 
F irlmproc,STATUS,PARTNER 


Irimy is either the VTAM name of the other IRLM or the VTAM 
name of this IRLM for the alternate session. Each IMS/VS sub- 
system connected to irlmy is displayed, along with an indicator 
as to whether the IMS/VS system is active or not. 


The meaning of values x, y, z, and a are: 
x The VTAM name of the other IRLM. 


y The IRLMID of the other IRLM. If the value is unknown 
a '?' is inserted in this field. This would occur, for 
example, if the IRLMs were not connected, and had not 
been previously connected. 


z The VTAM name of the IRLM which received the 
command. 
a The IRLMID of the IRLM which received the command. 


Note: The IRLMs do not communicate to process the STATUS 
command. Ifthe first line in the display specifies 'COMM OUT', 
then 'irlmproc' may not have the most recent information about 
the status of IMS/VS subsystems connected to the VTAM name 
of the other IRLM. 
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The values of nnnn are: 


NORMAL Both IRLMs have VTAM sessions established and 
are conducting normal communications. 


DOWN Both IRLMs did not have VTAM sessions estab- 
lished, because the other IRLM failed or terminated 
normally. 


COMM OUT 
Both IRLMs did not have VTAM sessions established 
because of a communications failure. 


IN DOUBT 
Both IRLMs did not have VTAM sessions established 
and neither IRLM knows if the other is executing or 
not. 

INITIAL Both IRLMs do not currentiy have VTAM sessions 


established. This status indicates that no session 
was ever established or that processing was com- 
pleted after a previous communication link or IRLM 
failure. 


SYSTEM-FAILED 
Neither IRLM has a VTAM session established. 
Either one IRLM was informed via the 
SETSTATE,SYSTEM command that the other IRLM 
failed, or one IRLM was started with the 
RULES = AVAIL option and the other IRLM termi- 
nated. 


ALTERNATE YES 
The alternate session specified by 'irlmy' is con- 
nected to another IRLM. The status of the IMS/VS 
systems connected to the IRLM on the opposite end 
of the alternate session is unknown. 


ALTERNATE NO 
The alternate session specified by 'irlmy' was not 
established. The other I[RLM’s IRLMID is unknown 
at this time. 


The meaning of variables m, ssname, and zzz are: 


Variable Meaning 

m A decimal number (1, 2, etc.). Where more than 10 
Jines are required in response to a status 
command, multiple messages are issued, with m 
increased by one in each successive message. 

ssname An 8-character IMS/VS subsystem name. 

2zz A value of UP indicates that the IMS/VS subsystem 


is active. A value of DOWN indicates that the 
IMS/VS subsystem has failed. A value of 'UP-RO' 
indicates that the IMS/VS subsystem is active, and 
is currently identified to the IRLM as a read-only 
subsystem. 


If no IMS/VS subsystems are identified to irlmy, the line begin- 
ning with ssname is replaced with 'NO INFORMATION 
AVAILABLE' 


System Action: Processing continues normally. 


DXR011! irlm END-OF-TASK CLEAN-UP SUCCESSFUL 


Explanation: The IRLM end-of-task routine has released ail of 
the MVS common storage that was in use by the terminating 
IRLM. 


System Action: Processing is terminated. Command 'S 
irlmproc' may be entered to restart the IRLM. 


DXRO012E irim irimx NOT KNOWN 


Explanation: A response is made in reply to commands 'F 
irlmproc,STATUS,irimx'. It indicates that the IRLM with the 
VTAM application name 'irlmx' is not known. 


System Action: Processing continues normally. 


System Programmer Response: Verify that the VTAM applica- 
tion name of the other IRLM is ‘irlmx' and that all of the VTAM 
definitions relative to the two IRLMs are correct and active to 
VTAM. 


Operator Response: If the wrong name was specified, reenter 
the command, specifying the correct name. If the correct name 
was specified, notify the system programmer. 


DXRO13E irlm ABEND UNDER IRLM TCB/SRB 


Explanation: The IRLM encountered an irrecoverable pro- 
gramming error while processing under an IRLM execution 
unit. Global sharing with the IRLM issuing the message was 
inhibited. An MVS SYS1.LOGREC record has been written and 
an SDUMP requested. 


System Action: The IRLM terminates abnormally. 


System Programmer Response: Use the print dump service 
aid to print the dump and analyze the dump to determine the 
cause Of the failure. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message fog output 

¢ The IRLM address space dump generated at the time of 
failure 

¢. The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

e A listing of the IRLM start procedure JCL 

¢ Alisting of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXR014E Irilm INVALID MODIFY COMMAND PARAMETER 


Explanation: A response was made to a MODIFY command 
that specified the procname of this IRLM, which contained 
unsupported parameters or an invalid parameter. 


System Action: Processing continues normally. 


Operator Response: Reenter the MODIFY command with the 
correct parameters. 


DXRO15E irlm STORAGE NOT AVAILABLE FOR COMMAND 


FUNCTION 


Explanation: The IRLM cannot obtain sufficient internal 
working storage to process the command function. 


System Action: Processing continues normally. 


System Programmer Response: The region size specified on 
the IRLM procedure should be increased. 


Operator Response: Notify the system programmer. The 
command may be reentered later. 


DXRO12E — DXRO18E 


DXRO16E irim BUCK PROCESS TIME HAS EXCEEDED 30 


SECONDS 


Explanation: An IRLM pass-the-buck (PTB) cycle was not com- 
pleted after 30 seconds, which may indicate a problem. This 
condition can occur when the other system is in stopped state. 


System Action: The IRLM continues processing. 


Operator Response: If this message appears several times 
within a short period of time and the other system is not in 
stopped state, notify the system programmer. If the other 
system is in a stopped state, ignore the message. 


System Programmer Response: This message indicates signif- 
icant delay in the IRLM processing. The delay may be caused 
by a VTAM, communication, hardware, or IRLM problem. 


DXRO17E irim ABEND UNDER IMS/VS TCB/SRB, ERROR 


ID=zz 


Explanation: The IRLM encountered an irrecoverable pro- 
gramming error while processing a request executing under an 
IMS/VS subsystem execution unit. Global sharing with the 
IRLM issuing the message is inhibited. The message shows the 
MVS error ID (zz) associated with the failure. An MVS 
SYS1.LOGREC record has been written and an SDUMP 
requested. 


System Action: Processing terminates abnormally. 


System Programmer Response: Use the print dump service 
aid to print the dump and analyze the dump to determine the 
cause of the failure. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

¢ The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

e A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXRO018E irlm INITIALIZATION ABEND 


Explanation: The IRLM encountered an irrecoverable error 
during initialization. Global sharing with the IRLM issuing the 
message is inhibited. An MVS SYS1.LOGREC record has been 
written. Message DXROO8E precedes this abend and contains a 
FAILED CODE = xx value. For all cases, where xx = 1, 2, 6, 7, 8, 
or 13 an MVS SDUMP has been requested. 


System Action: The IRLM terminates abnormally. 


System Programmer Response: Message DXROO8E precedes 
this message when IRLM fails. Refer to the error code dis- 
played in message DXROO8E. If more information is needed 
and an SDUMP was taken, use the print dump service aid to 
print the dump and analyze the dump to determine the cause of 
the failure. 
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Operator Response: Notify the system programmer. If an 
SDUMP was taken, ensure that the SYS1.DUMPxx data set con- 
taining the SDUMP is not overwritten before it is printed. 


Problem Determination: Save the following information: 


* The MVS hardcopy message Iog output 

e The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

° A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXRO19E irim STORAGE POOL DESTROYED 


Explanation: The IRLM detects invalid or inconsistent informa- 
tion within the storage pool contro! which inhibits global 
sharing with the IRLM. An MVS SYS1.LOGREC record has been 
written and an SDUMP requested. 


System Action: Processing terminates abnormally. 


System Programmer Response: Use the print dump service 
aid to print the dump and analyze the dump to determine the 
cause of the failure. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

*® The IRLM address space dump generated at the time of 
failure 

« The dump of any IMS/VS online or batch address space that 

' failed near the time of the IRLM failure. Follow IMS/VS 

problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

* A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to instal! the IRLM 

¢ Listings of the VTAM definitions performed to install the 
{RLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXR020E irlm ABENDED VIA MODIFY COMMAND 


Explanation: When an 'F irlmproc,ABEND' command is 
received, the IRLM is terminated. Global sharing with the IRLM 
_ issuing the message is inhibited. An MVS SYS1.LOGREC 
record has been written and an SDUMP requested. 


System Action: The IRLM terminates abnormally. 


Operator Response: Notify the system programmer. If an 
SDUMP was taken, ensure that the SYS1.DUMPxx data set con- 
taining the SDUMP is not overwritten before the dump is 
printed. 


System Programmer Response: Use the print dump service 
aid to print the dump and analyze the dump to determine the 
cause of failure. 
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Probiem Determination: Save the following information: 


* The MVS hardcopy message log output 

* The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXRO21E 


Explanation: A VTAM error status indicates that a VTAM 
request was submitted or a combination of VTAM request types 
and parameters not used by IRLM was encountered. Global 
sharing with the IRLM issuing the message is inhibited. An 
MVS SYS1.LOGREC record has been written and an SDUMP 
requested. 


irim ABEND VTAM ERROR 


System Action: Processing terminates abnormally. 


System Programmer Response: Analyze the dump to deter- 
mine the cause of the failure. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow iRLM 
restart procedures. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

¢ The IRLM address space dump generated at the time of 
failure 

e The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

© A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXR022E irim ABNORMALLY TERMINATED DUE TO 


SUBTASK FAILURE 


Explanation: An IRLM subtask has abnormally terminated. An 
MVS SYS1.LOGREC record has been written and an SDUMP 
requested. 


System Action: The IRLM terminates processing abnormally. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


System Programmer Response: Use the print dump service 
aid to print the dump and analyze the dump to determine the 
cause Of the failure. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

e¢ The IRLM address space dump generated at the time of 
failure 

* The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

* A listing of the IRLM start procedure JCL 

© Atisting of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to instal! the 
{RLM 

© The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXRO23E irlm INTERNAL OR MVS ERROR 


Explanation: IRLM encountered an internal logic error or 
received an error from a required MVS service. An example of 
an IRLM internal error is detection of an invalid function code in 
an internal queue element. An example of an MVS service 
failure is a nonzero return code from SETDIE. The IRLM dead- 
lock and intersystem communications functions cannot be per- 
formed without SETDIE services. The error condition caused 
the IRLM to terminate with abend U2023. Global sharing with 
the IRLM issuing the message is inhibited. An MVS 
SYS1.LOGREC record has been written and an SDUMP 
requested. 


System Action: The IRLM terminates processing abnormally. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


System Programmer Response: Use the print dump service 
aid to print the dump and analyze the dump to determine the 
cause of the failure. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message fog output 

¢ The IRLM address space dump generated at the time of 
failure 

* The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
probiem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM faiture. 

¢ A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to install the IRLM 

® Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXR025! irlm SESSION LOST, SHARING STATE IS zzzz 


Explanation: The VTAM session with another IRLM has termi- 
nated or cannot be established. 


The zzzz value is indicated by one of the following: 


INITIAL An attempt to establish a session with the other 
IRLM failed. Since no session has been established, 
the IRLM continues in the initial sharing state which 


permits the granting of any global locks. 


COMM FAILED 
The IRLM continues its operation in 'COMM 
FAILED' sharing state. 


DXRO23E — DXRO27A 


IRLM FAILED 
The other IRLM is inactive and may have terminated 
normally or abnormally. When it terminates abnor- 
mally, a SIGNAL is received from the other IRLM. 
When it is normal, a 'final buck' is received. 


SYSTEM FAILED 
The IRLM continues operation in system-failed 
sharing state. 


System Action: The IRLM continues processing in the global 
sharing state shown in the message. 


DXR026I irlm SETSTATE COMMAND zzzzz 


Explanation: A message is issued in response to a MODIFY 
command with a SETSTATE parameter. 


The zzzzz value is indicated by one of the following: 


ACCEPTED STATE IS IRLM FAILED 
The command sets sharing state to IRLM FAILED. 


ACCEPTED STATE IS SYSTEM FAILED 
The command set sharing state to SYSTEM-FAILED. 


ACCEPTED STATE IS COMM FAILED 
The command sets sharing state to COMM FAILED. 


REJECTED, INVALID PARAMETERS 
A value other than IRLM or COMM is entered as the 
failure reason. 


REJECTED STATE IS NOT IN DOUBT 
The command is received at a time when the IRLM 
sharing state is not IN DOUBT, and is other than a 
change from COMM FAILED to IRLM FAILED. 


REJECTED INVALID CHANGE 
The command specified a change to 'COMM 
FAILED' and the current state is 'IRLM FAILED '.. 
‘IRLM FAILED ' is a less restrictive state than 
‘COMM FAILED '. It is too late to be more restric- 
tive. 


System Action: When the new sharing state is displayed in the 
message, the IRLM begins granting global lock requests, using 
the rules of 'IRLM FAILED' or 'COMM FAILED' as indicated. 


DXR027A _—siirlm SESSION LOST, SHARING STATE IS IN 


DOUBT ACTION REQUIRED 


Explanation: A VTAM operation was completed with an 
abnormal completion status, or an !|RLM VTAM exit was entered 
because of an exception condition. This IRLM cannot deter- 
mine whether or not the other IRLM is executing. 


Operator Response: VTAM has indicated that a problem exists 
but did not indicate whether the other IRLM is still operational. 
After determining where the problem is, perform the following 
actions: 


e Ifthe other IRLM has terminated, issue a MODIFY command 
with SETSTATE,IRLM to this IRLM. After restarting the 
other IRLM, issue a MODIFY command with the ACTCOMM 
parameter to this IRLM to reestablish the session. 


Care must be taken when specifying SETSTATE,IRLM to 
ensure that the other IRLM has been terminated. This state 
is much less restrictive than the SETSTATE,COMM state. [ff 
you specify SETSTATE,IRLM and the other IRLM is active, 
data base integrity is exposed. 


¢ ifthe problem is a VTAM or communications problem and 
the other IRLM is still executing, issue a MODIFY command 
with SETSTATE,COMM to both IRLMs. After both IRLMs 
have issued message DXRO35A, issue a MODIFY command 
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with SETSTATE, INIT to both IRLMs. After the communi- 
cations problem has been corrected, enter the MODIFY 
command with the ACTCOMM parameter to both IRLMs to 
reestablish the session. 


e If both IRLMs have remained in operation and neither IRLM 
has had a MODIFY command with SETSTATE issued, issue 
a MODIFY command with the ACTCOMM parameter to both 
IRLMs to request reestablishment of the session. If the 
other IRLM has terminated, or a MODIFY command with 
SETSTATE has been issued to the other IRLM, a MODIFY 
command with SETSTATE must be issued to this IRLM 
before reestablishing this session. 


Note: At the time the session is reestablished, one IRML is 
not allowed to be in INDOUBT state while the other is in 
INITIAL state. 


¢ [fthe MVS system on which one IRLM is executing fails, 
issue a MODIFY command with SETSTATE,SYSTEM to the 
other IRLM. After starting the failed MVS system and its 
IRLM, issue a MODIFY command with the ACTCOMM 
parameter to the IRLM that continued operations to rees- 
tablish the session. 


To recover the failed system and reestablish the session, 
do the following: 


— Restart MVS. 
— Restart the IRLM that was active on the failed system. 


— Issue a MODIFY command with the ACTCOMM param- 
eter to the IRLM that did not fail. 


—~ Restart ail online IMS/VS subsystems that were exe- 
cuting on the failed MVS system. 


— Run a batch DBRC utility job to remove authorization 
from RECON of all read-with-integrity batch jobs active 
on the failed system at the time of failure. 


— Run batch backout for any block-level data sharing 
batch update jobs executing on the failed MVS system. 


These steps do not need to be executed in this sequence. 
However, the IRLM must be restarted before the iIMS/VS 
subsystem is restarted and batch backout jobs are exe- 
cuted. 


System Action: The IRLM VTAM session is terminated. The 
IRLM global sharing function is disabled. Global lock requests 
are being queued until the condition is corrected. A SETSTATE 
command or successful reestablishment of the session by the 
ACTCOMM command will correct the problem. When either of 
these events occurs, a DOM request is issued to delete the 
message. 


DXRO28A irlm IRLMID = x invalid for y, 


REASON = za 


Explanation: Once the IRLMs establish a VTAM session, they 
exchange IRLMIDs. The IRLMID received by 'irlm' is invalid. 
The meaning of x, y, z, and a is as follows: 


Value Meaning 

x The IRLMID passed by the other IRLM. 

y The VTAM application name of the other IRLM. 
z Reason code. 

a A modifier, applicable to reason code 3. 


z=1 The IRLMID of the other IRLM has the same value as 
the ID of this IRLM. 
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z=2 The {RLMID of the other IRLM is not in the range of 1 
through 8. 


z=3 The IRLM which issued this message requires that 
the IRLMID of the other IRLM be 'A'. However, the 
other IRLM provided. a value of 'x'. 


System Action: The VTAM ACB is closed and the IRLM that 
issued this message continues in the global sharing state that 
existed before the error was detected. F irlmproc,ACTCOMM is 
necessary to cause this IRLM to reinitiate a connect sequence. 


System Programmer Response: The action for the codes men- 
tioned above is: 


Code Action 


For z=2 An internal logic error has occurred. Save the 
dump from the IRLM issuing this message. Obtain 
a dump of the other IRLM with the command F 


irlmproc,ABEND. 


z=ior3 if the IRLM with VTAM name y was started with x 
as the IRLMID, then execution of one of the IRLMS 
must be terminated. Restart the terminated IRLM, 
specifying an IRLMID value acceptable to the other 
IRLM. Then issue an ACTCOMM command to the 


IRLM that continued executing. 
Probiem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

¢ The IRLM address space dump generated at the time of 
failure 

¢ A listing of the IRLM start procedure JCL 


DXR029i irlm ceccccce NOT SUPPORTED FOR SCOPE 


EQUAL LOCAL 


Explanation: cccccccc is either an ACTCOMM, SETSTATE, or 
PTBTRACE parameter. When a MODIFY command specifies 
either the ACTCOMM, SETSTATE, or PTBTRACE parameter and 
the IRLM was started with a LOCAL execute parameter, this 
message is issued. The ACTCOMM, SETSTATE, and 
PTBTRACE functions cannot be performed in LOCAL mode. 


System Action: The IRLM continues processing as it did before 
the command was received. 


DXRO301 irlm ACTCOMM IGNORED, VTAM ACB ALREADY 


OPENED 


Explanation: A MODIFY command specifying the ACTCOMM 
parameter was received and the IRLM cannot perform the 
ACTCOMM action because the VTAM operations are already in 
progress. 


System Action: The IRLM continues processing as it did before 
the command was received. 


DXROS1E irim ABEND UNDER PTB SRB, ERROR ID = zzzzz 


Explanation: A pass-the-buck (PTB) functional recovery routine 
(FRR) was entered because of a failure in the execution under a 
PTB SRB. 2zzzz is the MVS error ID extracted from the system 
diagnostic work area (SDWA). 


System Action: The IRLM terminates abnormally. An SDUMP 
is requested by the IRLM jobstep ESTAE. 


Operator Response: Notify the system programmer and follow 
the IRLM restart procedure. 


System Programmer Response: Analyze the SDUMP. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

* The IRLM address space dump generated at the time of 
failure 

© The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A |tisting of the IRLM start procedure JCL 

* A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
{RLM 

* The GTF trace output, if any is available showing activity at 
the time of the failure. 


DXRO032i irim STOP COMMAND ACCEPTED 


Explanation: The IRLM has accepted the STOP command and 
is beginning the normal shutdown process. 


System Action: The IRLM is performing shutdown processing. 
If a VTAM session is established with another IRLM, the other 

IRLM is informed via the PTB function of the shutdown and the 
IRLM subtasks are quiesced and detached. 


DXR033E Irim irimx LOGON REQUEST FROM VTAM LU =x 


REJECTED 


Explanation: This message is issued when x is not the same as 
the second subparameter of APPLS. It is also issued when 
IRLMs are not at compatible release levels. 


The VTAM name of the application requesting the LOGON is 
cae 

The VTAM name of this IRLM for the session experiencing the 
error is 'irlmx'. 


System Action: The IRLM continues operation. The VTAM 
session is not established. 


Operator Response: Notify the system programmer. 


System Programmer Response: if x is the intended partner of 
‘irlm', then terminate and restart 'irlm' with the correct APPLS 
parameter. Verify that the same retease level is being used for 
both IRLMs. If not, upgrade the down-level IRLM. 


DXRO034I irlm zzzzzzz REJECTED, xxxx-FAILED CLEANUP 


NOT COMPLETE 


Explanation: A MODIFY command specifying the ACTCOMM or 
SETSTATE parameter was received, and the IRLM cannot 
perform the ACTCOMM action because it is in the process of 
cleaning up from an IRLM, SYSTEM, or COMM failed condition. 


The value of zzzzzzz is either the ACTCOMM or the SETSTATE 
parameter and xxxx is the IRLM, SYSTEM, or COMM. 


System Action: Processing continues as it did before the 
command was received. 


Operator Response: When the IRLM is in a COMN-failed state, 
wait for message DXR035A.. When message DXRO35A is issued 
by both IRLMs, enter the SETSTATE, INIT command. 


DXRO032!1 — DXRO37A 


When the IRLM is in an IRLM-failed state, wait 5 minutes or until 
the IRLM enters the INITIAL state and then reenter the 
ACTCOMM command. (The IRLM STATUS, irlmx command may 
be used to determine when the JRLM has entered the INITIAL 
state. irlmx is the VTAM application name of the IRLM to which 
this IRLM was previously connected.) When the IRLM is in the 
INITIAL state, the first line of the response to the STATUS 
command is: 


DXRO1OI irim irimx STATUS INITIAL 


DXRO35A irlm ENTER SETSTATE,INIT WHEN BOTH IRLMS 


ISSUE THIS MESSAGE 


Explanation: This message is issued when the IRLM and its 
connected IMS/VS systems have completed COMN-failed 
cleanup processing. One of the IRLMs must not enter the 
INITIAL state until both have completed the COMM-failed 
cleanup. Otherwise, read-with-integrity batch jobs, because of 
the updates performed by IMS/VS connected to the other IRLM, 
may READ inconsistent data. Because the two IRLMs cannot 
communicate with one another, the operator(s) must assist. 


System Action: The IRLM is waiting for the SETSTATE, INIT 
command. No global locking is being performed. 


Operator Response: When this message has been issued by 
both IRLMs, use the MODIFY command with the SETSTATE, INIT 
parameters to inform both IRLMs that the failure cleanup is now 
complete. 


When the other IRLM has terminated the execution, enter the 
MODIFY command with SETSTATE,INIT parameters to the IRLM 
which has not terminated. 


DXRO36A irlm applid1 SECONDARY SESSION WITH applid2 


LOST 


Explanation: A VTAM operation on an alternate session com- 
pleted with an abnormal completion status, or an IRLM VTAM 
exit was entered for an exception condition on an alternate 
session. j 


The VTAM application name of the IRLM issuing the message is 
‘applidt'. 


The VTAM application name for the partner of the IRLM issuing 
the message is 'applid2'. 


System Action: The IRLM continues operation. The IRLM 
VTAM alternate session terminates. 


Operator Response: Attempt to determine the problem. Obtain 
the assistance of the system programmer, if required. 


DXRO037A irlm applid SESSION LOST. WAITING FOR TAKE- 


OVER OR OPERATOR INTERVENTION 
Explanation: One of the following conditions occurred: 


¢ AVTAM operation on the primary session completed with 
an 
abnormal completion status. 

¢ An !RLM VTAM exit was entered for an exception condition 
on the primary session, and a secondary session was 
established with another IRLM to which an alternate IMS/VS 
was identified. 


If the failure causes the alternate IMS/VS to begin takeover 
processing, the secondary session will become the primary 
session, and data sharing will begin over the new session. 


If the failure does not result in takeover processing, the situ- 
ation is the same as a communication or system failure in a 
non-XRF environment. 
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DXRO38I — DXRO046I 


The VTAM application name of the IRLM issuing the message is 
‘applid'. 


System Action: Communication with the other IRLM on the 
primary session was terminated. If takeover occurs, PTB com- 
munication will be established over the secondary session. lf 
takeover does not occur, the IRLMs involved in the primary 
session operate in INDOUBT state. 


Operator Response: /f a takeover occurs, no operator 
response is required. If a takeover does not occur, the oper- 
ator should treat the situation as a communication or system 
failure in a non-XRF environment. 


DXRO38I irim TAKEOVER COMPLETE. PRIMARY SESSION 


IS irlmx. 


Explanation: Takeover processing is complete. The original 
primary session was terminated, and the alternate session 
‘irlmx' is now the primary session. This message follows 
message DXR0371 if no errors were encountered during take- 
over processing. 


The VTAM name of this IRLM for the primary session is ‘irlmx'. 


System Action: The IRLM continues operation. The IRLM is 
performing data sharing communication over session 'irlmx'. 


DXRO391 irim SESSION DEMOTED TO SECONDARY DUE TO 


TAKEOVER 


Explanation: This message is issued in an XRF/data-sharing 
environment when an IRLM receives a takeover indication in 
the 'buck'. An IMS/VS subsystem identified to the IRLM issuing 
the message has been taken over. The data-sharing partner 
IRLM has reconfigured the VTAM sessions so that it now has a 
primary session with another IRLM. 


System Action: This IRLM continues operation in 'COMM 
FAILED' mode. The session with the other IRLM is demoted to 
secondary. 


irim PURGE, nnnnnnnn COMMAND FAILED 
yYYYYYyy 
Explanation: This message is issued when a PURGE command 


specifies an IMS/VS name not known to this IRLM or when the 
IMS/VS subsystem is active. 


DXRO401 


The variables nnnnnann and yyyyyyyy are defined as follows: 


nannnannn An 8-character IMS/VS subsystem name 


YYYYYYYY The reason the PURGE command failed 


The value of yyyyyyyy is replaced with one of the following: 


. PURGE IN PROGRESS 

Indicates that either another PURGE command is 
being processed, or the IRLM is cleaning up from an 
IRLM, system, or communications failure: 


NAME NOT FOUND OR ACTIVE 
Indicates that the IMS/VS subsystem specified 
cannot be found or that it is active and cannot be 
purged. 


System Action: Processing continues normally. 


Operator Response: Reenter the PURGE command with the 
’ correct parameters. 
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irim ACTCOMM ISSUED TO AN IN DOUBT IRLM 
WHOSE PARTNER IS NOT IN DOUBT 


DXRO42E 


Explanation: An attempt was made to establish a session 
between two IRLMs. However, one IRLM was IN DOUBT and 
the partner was in a state other than IN DOUBT. This was an 
improper reconnect and the IN DOUBT IRLM terminated with 
abend U2025. An MVS SYS1.LOGREC was written and an 
SDUMP requested. 


System Action: The IN DOUBT IRLM terminates abnormally. 


Operator Response: Restart the IRLM that terminated abnor- 
mally, and issue the ACTCOMM command to the partner IRLM. 


DXRO0431 irlm SESSION BETWEEN applid1 AND applid2 IS 


NOW PRIMARY 


Explanation: The secondary session between two JRLMs has 
been promoted to primary. 


The VTAM application name of the IRLM issuing the message is 
‘applid1'. 


The VTAM application name of the partner of the IRLM issuing 
the message is 'applid2ssq.. 


System Action: PTB internal trace begins for the two IRLMs in 
this session. Data sharing may now occur between subsystems 
identified to the IRLMs. 


DXR044! irlm PRIMARY SESSION BETWEEN applid1 AND 


applid2 HAS BEEN DEMOTED TO SECONDARY 


Explanation: The primary session is being demoted to sec- 
ondary because of session reconfiguration. Another session 
within the XRF/data sharing complex is being promoted to 
primary, so this session must become secondary. 


The VTAM application name of the IRLM issuing the message is 
‘applidt'. 


The VTAM application name of the partner of the IRLM issuing 
the message is 'applid2’. 


System Action: PTB communication between the IRLMs stops. 


DXRO45W ___irlm sess-type SESSION BETWEEN applid1 AND 


applid2 HAS BEEN LOST AND RECOVERED 


Explanation: The specified session was lost and subsequently 
recovered. 


The session type, either PRIMARY or SECONDARY, is 
"sess-type'. 


The VTAM application name of the IRLM issuing the message is 
‘applid1'. 


The VTAM application name of the partner IRLM is ‘applid2'. 


System Action: The lost session was recovered. Normal 
session activity resumes. 


DXRO046I irlm TAKEOVER NOTIFICATION RECEIVED. 
SESSION RECONFIGURATION IN PROGRESS FOR 


SESSION applid 


Explanation: The IRLM issuing the message received notifica- 
tion from the secondary session partner that an alternate 
IMS/VS system has begun takeover processing. 


The VTAM application name of the IRLM issuing the message is 
‘applid'. 


DXR047i — DXRO47I 


System Action: Session reconfiguration will occur because of m= This IRLM’s IRLM id. 
the takeover. The session defined by “applid” will be promoted ee , 
: b= VTAM application name of the partner }RLM for this 
to primary as part of the takeover process. ; 
session. 
DXR047! _irlm SESSION STATUS ae REG UREM Se OtiG Hannet: 
APPL ID APPL ID TYPE IN-SESSION STATE aaaam t= Session type (PRI for primary and SEC for sec- 
bbbb n_eseittt yyy ssss ondary). 
Explanation: This message provides information concerning y= YES if session is established and NO if it is not. 
plkerineihe session status and is a response to the following — Sharing state of the |RLM: 
d INITIAL 
f irimproc,STATUS,SESSION NORMAL 
: : SYS-FAIL 
The meaning of values a,b,m,n,s,t, and y are: COM-FAIL 
a= VTAM application name of this RLM for the session. 


System Action: Processing continues normally. 
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IRLM Error Return and Reason Codes 


IDENT Request 


The IRLM error return and reason codes that apply to DB2 operation are listed 
below. For the complete list of IRLM error return and reason codes refer to IMS/VS 
Version 1 Messages and Codes Reference Manual (IMS/VS Version 1 M Codes Ref- 
erence Manual. 


The values shown in the 'return code’ column are the request completion status: 


0 
4 


12 


16 


20 


Return 
Code 


04 


08 


16 


20 


Indicates the request completed successfully. 


Indicates the request completed successfully, but the state of lock 
remained unchanged. 


Indicates the request completed unsuccessfully because of a system 
error or condition, not a problem in the request. 


Indicates the request completed unsuccessfully because of a logic error 
in the request. 


Indicates the request completed unsuccessfully because of an invalid 
request specification. 


Indicates the request completed unsuccessfully because IRLM 
resources are not available. 


Reason 

Code Description 

X'08' The IRLM is operating in COMM FAIL or IRLM FAIL STATE. 

X'10' Locks held from previous IDENT(s). 

X'80' System error. A nonrecoverable error occurred while processing 
this request. 

X'40' MVS SSI Error. An MVS SSI error occurred during an identifica- 


tion process. Ensure that the 4-character IRLM name used by the 
subsystem to identify to the IRLM has been defined as an MVS 
subsystem, and that the IRLM subsystem with the same name has 
been started. 


Xx'04' Identify for recovery (SSTYPE = RECON) requested but this IRLM 
has no retained information regarding this IMS/VS. 


X'01' Out of storage. There is insufficient storage for the IRLM to 
process the IDENT request. When all other subsystems identified 
to the IRLM have quit, terminate the IRLM, and increase the 
storage available to the IRLM before restarting it. 


X'40' SSNAME already active. A subsystem or a batch job with the 
same name is currently identified to this IRLM, or to the IRLM 
connected to this IRLM. Wait until the first subsystem or job com- 
pletes before starting the second subsystem or job with the same 


name. 
X'20' Required exit missing. 

X'10' SSTYPE = RD not allowed. Locks are retained. 
X'02' Function level not supported. 

N/A IRLM services are not available. 
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QUIT Request 


Return 
Code 


04 
08 


12 
16 
20 


LOCK Request 


Return 
Code 


04 


04 
08 


12 
16 


20 
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Reason 
Code 


X'10! 
X'80'! 


X'01! 


X'01! 
N/A 
N/A 


Reason 
Code 


X'20' 
X'10' 
X'04' 
X'80' 


X'40' 
X'20' 
X'10' 
X'08' 
X'01!' 


X'80' 
X'40' 
X'20' 
X'10' 
X'08' 
X'04' 
X'02' 
N/A 


Description 
Held locks retained. 


System error. A nonrecoverable error occurred while processing 
this request. 


Out of storage. There is insufficient storage for the IRLM to 
process the QUIT request. When all other subsystems identified 
to the IRLM have quit, terminate the IRLM, and increase the 
storage available to the IRLM before restarting it. 


Locks held; HELD parameter omitted. 
More than one QUIT was received from the subsystem. 


IRLM services are not available. 


Description 

Other holders exist. 

Lock already held. 

PRIVATE lock request held by some holder. 


System error. A nonrecoverable error occurred while processing 
this request. 


Incompatible MODE = COND. 

Deadlock. 

Incompatible lock held by failed subsystem. 

Reject because of IRLM/COMM failed cleanup in progress. 


Out of storage. There is insufficient storage for the IRLM to 
process the LOCK request. When all other subsystems identified 
to the IRLM have quit, terminate the IRLM, and increase the 
storage available to the IRLM before restarting it. 


The subsystem does not hold the specified COMMEQV lock. 
Invalid CLASS. 

Invalid STATE. 

Invalid COMMEQV token. 

Invalid SCOPE. 

Invalid TOKEN. 

Invalid RNA length. 


IRLM services are not available. 


UNLOCK Request 


NOTIFY Request 


Return 
Code 


04 


08 


12 


16 


20 


Return 
Code 


04 


08 


12 


16 
16 
20 


Reason 
Code 


X'20' 
X'08' 
X'04' 
X'80' 


X'01! 


X'40' 
X'20' 
X'08' 
X'04' 
X'40' 
X'20' 
X'04' 
X'02' 
N/A 


Reason 
Code 


X'80' 
X'02' 
X'80' 


X'01! 


X'40! 
X'20' 
X'08' 
X'04' 
N/A 


‘Description 


Other locks are held in other states. 
Lock not released. 
Work unit holds locks in other classes. 


System error. A nonrecoverable error occurred while processing 
this request. 


Out of storage. There is insufficient storage for the IRLM to 
process the UNLOCK request. When all other subsystems identi- 
fied to the IRLM have quit, terminate the IRLM, and increase the 
storage available to the IRLM before restarting it. 


Lock not held by work unit. 

No lock exists for specified RNA. 

Lock not held in specified STATE. 

Lock is held by work unit, but not in specified class. 
Invalid CLASS. 

Invalid STATE. 

Invalid TOKEN. 

Invalid RNA length. 


IRLM services are not available. 


Description 
Asynchronous request accepted. 
One or more holders have failed and hence could not be notified. 


System error. A nonrecoverable error occurred while processing 
this request. 


Out of storage. There is insufficient storage for the IRLM to 
process the NOTIFY request. When all other subsystems identi- 
fied to the IRLM have quit, terminate the IRLM, and increase the 
storage available to the IRLM before restarting it. 


Lock not held by work unit. 

No lock exists for specified RNA. 
Zero length message. 

Invalid TOKEN. 


IRLM services are not available. 
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VERIFY Request 


Return 
Code 


08 


20 


PURGE Request 


Return 
Code 


04 


08 


20 


CHANGE Request 


Return 
Code 


04 


08 
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Reason 
Code 
X'80' 


X'01! 


N/A 


Reason 
Code 


X'08' 
X'10' 
X'80' 


X'01' 


N/A 


Reason 
Code 


X'80! 


X'20' 


X'02' 


X'80' 


X'40' 


Description 


System error. A nonrecoverable error occurred while processing 
this request. 


Out of storage. There is insufficient storage for the IRLM to 
process the VERIFY request. When all other subsystems identi- 
fied to the IRLM have quit, terminate the IRLM, and increase the 
storage available to the IRLM before restarting it. 


IRLM services are not available. 


Description 


PURGE-required count decreased. 


No locks were retained. 


System error. A nonrecoverable error occurred while processing 
this request. 


Out of storage. There is insufficient storage for the IRLM to 
process the PURGE request. When all other subsystems identi- 
fied to the IRLM have quit, terminate the IRLM, and increase the 
storage available to the IRLM before restarting it. 


IRLM services are not available. 


Description 


CHANGE request completed successfully. Ownership and/or 
duration was specified, but no locks were changed. Either: 


1. The 'set of locks' specified included no held locks. 

2. All specified locks had a duration value greater than or equal 
to the specified duration. 

3. PSTATE=TSTATE specified. 


The CHANGE request completed successfully, but the state of the 
lock was not changed. CHANGE STATE request and other 
holders of the lock exist. 


The CHANGE request completed successfully, but the state of the 
lock was not changed. Resultant-state CHANGE STATE request 
specified 'tstate' value less than the current state of the lock. 


CHANGE request completed unsuccessfully due to a system error 
or condition, not an error in the request. A nonrecoverable error 
occurred while processing this request. 


CHANGE request completed unsuccessfully due to a system error 
or condition, not an error in the request. Lock was not available in 
the requested state. The CHANGE STATE request specified 
MODE = COND, and the request would have had to wait in order 
to obtain the requested state. 


Return 
Code 


12 


16 


Reason 
Code 


X'20' 


X'10' 


X'01' 


X'40' 


X'20' 


X'08' 


X'04' 


X'02' 


X'01! 


X'80' 


X'40' 


X'20' 


X'10' 


Description 


CHANGE request completed unsuccessfully because of a system 
error or condition, not an error in the request. The CHANGE 
STATE request was rejected because of deadlock. 


CHANGE request completed unsuccessfully because of a system 
error or condition, not an error in the request. The CHANGE 
STATE request cannot be granted because of the failure of 
another subsystem that holds the lock in a state incompatible with 
this request’s requested state. 


CHANGE request completed unsuccessfully because of a system 
error or condition, not an error in the request. This request could 
not be completed because of an out-of-storage condition. Either 
an MVS conditional GETMAIN failed or an amount of storage 
equal to MAXCSA (IRLM EXEC parameter) is already in use by 
other requests. 


CHANGE request completed unsuccessfully because of a logic 
error in the request. Resource not locked by specified work unit. 


CHANGE request completed unsuccessfully because of a logic 
error in the request. No lock exists for the specified resource 
hash and name values. 


CHANGE request completed unsuccessfully because of a logic 
error in the request. Count-by-state lock not held in the state 
specified by 'fstate'. 


CHANGE request completed unsuccessfully because of a logic 
error in the request. Resource is locked by the specified OWU, 
but not in the specified class. 


CHANGE request completed unsuccessfully because of a logic 
error in the request. A lock specified by this CHANGE request 
could not be changed because of the presence of suspended 
LOCK or CHANGE request against the lock. In the case where 
ownership/duration change of a group of locks was requested, 
some of the locks may have changed before this condition was 
detected. 


CHANGE request completed unsuccessfully because of a logic 
error in the request. The TWU already holds a lock or is waiting 
for a lock on a resource for which this request is attempting to 
transfer lock ownership. Ownership/duration change of some 
other locks specified by this request may have occurred before 
this condition was detected. 


CHANGE request completed unsuccessfully because of invalid 
specification of the request. Invalid 'tstate' specified. The value 
is greater than eight. 


CHANGE request completed unsuccessfully because of invalid 
specification of the request. Invalid CLASS specified. The value 
is greater than 31. 


CHANGE request completed unsuccessfully because of invalid 
specification of the request. Count-by-state lock, valid 'tstate', 
but 'fstate' of zero specified. 


CHANGE request completed unsuccessfully because of invalid. 
specification of the request. Both STATE and TWU were specified. 
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Return 
Code 


20 


QUERY Request 


Return 
Code 


00 


04 


08 


12 
i 
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Reason 
Code 


X'08' 


X'04' 


X'02' 


X'01' 


N/A 


Reason 
Code 


N/A 


X'80! 


X'01' 


X'80' 


X01! 


N/A 
X'80' 


X'08' 


X'04' 


Description 


CHANGE request completed unsuccessfully because of invalid 
specification of the request. STATE specified, but TOKEN and 
RNA omitted. 


CHANGE request completed unsuccessfully because of invalid 
specification of the request. Invalid TOKEN. The specified TOKEN 
parameter cannot be resolved to a lock held by the specified 
OWU. 


CHANGE request completed unsuccessfully because of invalid 
specification of the request. Invalid resource name length speci- 
fied. The length specified is less than two or greater than 32 
bytes. 


CHANGE request completed unsuccessfully because of invalid 
specification of the request. Invalid 'fstate' specified for a count- 
by-state lock. The value is greater than eight. 


CHANGE request completed unsuccessfully because IRLM func- 
tions are unavailable. No reason codes are returned. 


Description 


QUERY request completed successfully. No reason codes are 
returned. 


QUERY request completed successfully, but no information 
meeting the criteria of the specified parameters exists. 


QUERY request completed successfully, but the QUERY request 
did not specify an area large enough to contain all the data 
requested. The QUERY function quit processing when the next 
complete item would not fit in the area. 


QUERY request completed unsuccessfully because of a system 
error or condition, not an error in the request. A nonrecoverable 
error occurred while processing this request. 


QUERY request completed unsuccessfully because of a system 
error or condition, not an error in the request. This request could 
not be completed because of an out-of-storage condition. Either 
an MVS conditional GETMAIN failed or an amount of storage 
equal to MAXCSA (IRLM EXEC parameter) is already in use by 
other requests. 


Not used. 


QUERY request compieted unsuccessfully because of invalid 
specification of the request. Invalid AREA address. The AREA 
address is zero or invalid. 


QUERY request completed unsuccessfully because of invalid 
specification of the request. Invalid AREA length. The AREA 
length is less than four. 


QUERY request completed unsuccessfully because of invalid 
specification of the request. Invalid TOKEN. Either the TOKEN 
value does not correspond to an existing lock or the lock is not 
held by the designated OWU. 


Return 
Code 


20 


TAKEOVER Request 


Return 
Code 


00 


04 


08 


12 


16 
20 


Reason 
Code 


X'02!' 


N/A 


Reason 
Code 


N/A 


X'80' 


X'40' 


X'20' 


X'80' 


X'01! 


X'80' 


X'40' 


X'20! 


N/A 
N/A 


Description 


QUERY request completed unsuccessfully because of invalid 
specification of the request. Invalid resource name length. The 
length specified is less than two or greater than 32 bytes. 


QUERY request completed unsuccessfully because IRLM func- 
tions are unavailable. No reason codes are returned. 


Description 


Takeover completed successfully for an IMS/VS system that was 
identified either to this IRLM or to the IRLM in PTB communi- 
cation with this IRLM. Restart locks may be requested. No reason 
codes are returned. 


Takeover completed successfully for an IMS/VS system that was 
not known to this IRLM. 


Takeover compieted successfully for an IMS/VS system that was 
not known to this IRLM, but the alternate session was not suc- 
cessfully promoted to primary. 


Takeover completed successfully for an IMS/VS system that was 
not known to this IRLM. The alternate session was successfully 
promoted to primary. Global notify requests will not be resumed 
until the takeover complete purge is issued. 


Takeover did not complete successfully because a nonrecover- 
able system error occurred while processing the takeover 
request. 


Takeover did not complete successfully because of an out-of- 
storage condition. Either an MVS conditional GETMAIN failed, or 
an amount of storage equal to MAXCSA (IRLM EXEC parameter) 
is already in use by other requests. 


Takeover did not complete successfully because the IMS/VS 
system that issued the request was not identified as an alternate 
IMS/VS system. 


Takeover did not complete successfully because the IMS/VS 
system being taken over identified itself as an alternate IMS/VS 
system, or another IMS/VS system already issued a takeover 
request. 


Takeover did not complete successfully because a primary 
session with another IRLM has been established. The IMS/VS 
system being taken over was not identified to either this IRLM or 
to the IRLM now on the primary session. 


Not used. 


Takeover did not complete successfully because IRLM functions 
are unavailable. No reason codes are returned. 
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IRLM Abend Reason Codes 


2017 


Explanation: A functional recovery routine (FRR) was estab- 
lished by IRLM to intercept abends that occur during its exe- 
cution under the IMS/VS execution unit (TCB or SRB) during the 
processing of an RLMREQ request. 


The RLMREQ request or IMS/VS exit processing abended. An 
IRLM FRR has intercepted the abend and requested a recording 
of an MVS SYS1.LOGREC and an SDUMP of the failure. The 
FRR issued a CALLRTM to abend the !IRLM with completion 
code 2017. Console message DXRO17E, issued when the IRLM 
terminates, contains the MVS error !D recorded in the 
SYS1,.LOGREC record and in the SDUMP. 


System Action: The IRLM terminates abnormally. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing [RLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


Problem Determination: Save the following information: 


* The MVS hardcopy message log output 

* The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Fotlow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

* A listing of the iMSGEN performed to install the IRLM 

e Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


2018 


Explanation: The IRLM initialization failed. Console message 
DXROOS8E is issued at the time of the failure. A record of an 
MVS SYS1.LOGREC record and an SDUMP has been requested. 
At the time of the abend, register 15 contained the reason 
codes. Refer to IMS/VS Version 2 Failure Analysis Structure 
Tables (FAST) for Dump Analysis for the codes and their 
meanings. 


System Action: The IRLM is terminated abnormally. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing IRLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. 


Problem Determination: Save the following information: 


* The MVS hardcopy message log output 

* The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 


2017 — 2020 


problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
{RLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


2019 


Explanation: The IRLM storage manager has detected invalid 
or inconsistent control information within its storage pool struc- 
ture and does not attempt to complete the request that detects 
this error. Global sharing with this IRLM has terminated. MVS 
system console message DXR019E is issued at the time of the 
failure. A recording of an MVS SYS1.LOGREC record and an 
SDUMP has been requested. At the time of the abend, register 
15 contained the reason codes. Refer to IMS/VS Version 2 
Failure Analysis Structure Tables (FAST) for Dump Analysis for 
the codes and their meanings. 


System Action: The IRLM is terminated abnormally. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing IRLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


Problem Determination: Save the following information: 


* The MVS hardcopy message Iog output 

e The IRLM address space dump generated at the time of 
failure 

e The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

* A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


2020 


Explanation: The IRLM has been terminated abnormally by the 
‘F irlmproc,ABEND' command and global sharing with the 
IRLM was consequently terminated. Console message 
DXRO20E is issued at the time of the failure. A recording of an 
MVS SYS1.LOGREC record and an SDUMP has been requested. 
lf the NODUMP parameter was omitted, an SDUMP has been 
requesied. 


System Action: The IRLM is terminated abnormally. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing IRLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


if an SDUMP was taken, analyze the dump to determine the 
status of the IRLM at the time the dump was taken. 
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2021 — 2023 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

e The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

° A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GIF trace output, if any is available showing activity at 
the time of the failure. 


2021 


Explanation: VTAM returned an error status on a request sub- 
mitted by IRLM indicating that either an invalid VTAM request 
was submitted or a combination of VTAM request type and 
parameters not used by IRLM was encountered. Global sharing 
with the IRLM was terminated. Console message DXRO021E is 
issued at the time of the failure. A recording of an MVS 
SYS1.LOGREC record and an SDUMP has been requested. At 
the time of the abend, register 15 contained the reason codes. 
Refer to IMS/VS Version 2 Failure Analysis Structure Tables 
(FAST) for Dump Analysis for the codes and their meanings. 


System Action: The IRLM is terminated abnormally. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing IRLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


Problem Determination: Save the following information: 


* The MVS hardcopy message log output 

* The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

* A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

* The GTF trace output, if any is available showing activity at 
the time of the failure. 


2022 


Explanation: An IRLM subtask has abended. The end-of-task 
(ETXR) routine specified for the subtask by an ATTACH param- 
eter was entered. The end-of-task routine issued an abend 
U2022 to force IRLM to terminate. Global sharing with the IRLM 
terminated. MVS system console message DXR022E is issued 
at the time of the failure. A recording of an MVS SYS1.LOGREC 
record and an SDUMP has been requested. 


System Action: The IRLM is terminated abnormally. 
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Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM — 
restart procedures. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing IRLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


Problem Determination: Save the following information: 


* The MVS hardcopy message log output 

¢ The !RLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ Alisting of the IRLM start procedure JCL 

e A listing of the IMSGEN performed to install the IRLM 

e Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


2023 


Explanation: The IRLM encountered an internal logic error or 
received an error from an MVS service that must be performed 
in order for IRLM to continue execution. An example of an 
IRLM internal error is detection of an invalid function code in an 
internal queue element. An example of an MVS service failure 
is a nonzero return code from SETDIE. The IRLM deadlock and 
intersystem communications functions cannot be performed 
without SETDIE services. Global sharing with this IRLM has ter- 
minated. MVS system console message DXRO023E is issued at 
the time of the failure. A recording of an MVS SYS1.LOGREC 
record and an SDUMP has been requested. At the time of the 
abend, register 15 contained the reason codes. Refer to 
IMS/VS Version 2 Failure Analysis Structure Tables (FAST) for 
Dump Analysis for the codes and their meanings. 


System Action: The IRLM terminates abnormally. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing IRLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

¢ The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

¢ A listing of the IMSGEN performed to install the IRLM 

© Listings of the VTAM definitions performed to install the 
iRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 


2024 


Explanation: A functional recovery routine (FRR) was estab- 
lished by the IRLM to intercept abends that occur while exe- 
cuting under the IMS/VS execution unit (TCB or SRB) and 
during the processing of some RLMREQ request. 


The IRLM encountered an application program check while 
attempting to access an IMS/VS owned storage area: either an 
RLPL (RLMREQ interface control block) or some other storage 
address passed to the IRLM via the RLPL (for example, a 
VERIFY list). The error and the symptom string data have been 
recorded to SYS1.LOG REC, and the FRR has issued a 
command RETRY to DXRRL100 to clean up the IRLM owned 
structures. 


System Action: The IMS/VS dependent region is terminated 
abnormally. 


System Programmer Response: Notify the system programmer 
and ensure that the dependent region dump is available. 


Refer to the discussion of SYS1.DUMPxx in Section 5 of Diag- 
nosis Guide and Reference for information about printing IRLM 
dumps. Print and analyze the dump to determine the cause of 
the failure. This is an IMS/VS error. 


Problem Determination: Save the following information: 


The control sheet from the OS/VS console 
The input associated with the job 
The SYSOUT (system output) associated with the job 
The storage dump at the time of failure of the IMS/VS 
control region, and the dump of all associated message 
egions. (If SYS1.DUMP is used, it should be printed and 
saved.) 
* The SYSABEND dump. (if SYS1.DUMP is used, it should be 
printed and saved.) 
¢ Refer to the following manuals for further assistance to 
resolve your problem: 
1. IMS/VS Version 2 Failure Analysis Structure Tables 
(FAST) for Dump Analysis 
2. IMS/VS Version 2 Diagnosis Guide 
3. IMS/VS Version 2 Data Base Recovery Control: Guide 
and Reference 


2024 — 2031 


2025 


Explanation: An improper reconnect sequence followed an 
IRLM or COMM failure. Specifically, the ACTCOMM command 
was issued to two IRLMs, but only one was IN DOUBT. MVS 
system console message DXRO042E was issued at the time of 
failure. In addition, an MVS.SYS1.LOGREC record was written 
and an SDUMP was requested. 


System Action: The IN DOUBT IRLM terminates abnormally. 


Operator Response: Restart the IRLM that terminated abnor- 
mally and issue ACTCOMM to the partner IRLM. 


2031 


Explanation: An irrecoverable error occurred while executing 
under a pass-the-buck (PTB) SRB. The PTB FRR routine has 
been entered and it issued a CALLRTM with a completion code 
of abend U2031 to terminate the IRLM. The IRLM jobstep 
ESTAE has requested an SDUMP. 


System Action: The IRLM terminates abnormally. 


Operator Response: Notify the system programmer. Ensure 
that the SYS1.DUMPxx data set containing the SDUMP is not 
overwritten before the dump is printed. Then follow IRLM 
restart procedures. 


System Programmer Response: Refer to the discussion of 
SYS1.DUMPxx in Section 5 of Diagnosis Guide and Reference 
for information about printing IRLM dumps. Print and analyze 
the dump to determine the cause of the failure. 


Problem Determination: Save the following information: 


¢ The MVS hardcopy message log output 

¢ The IRLM address space dump generated at the time of 
failure 

¢ The dump of any IMS/VS online or batch address space that 
failed near the time of the IRLM failure. Follow IMS/VS 
problem determination procedures relative to the IMS/VS 
dump. The IMS failure may be related to the IRLM failure. 

¢ A listing of the IRLM start procedure JCL 

e A listing of the IMSGEN performed to install the IRLM 

¢ Listings of the VTAM definitions performed to install the 
IRLM 

¢ The GTF trace output, if any is available showing activity at 
the time of the failure. 
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Appendix A. CICS Transaction Abend/Dump Code (DSNC) 


DSNC 


Explanation: The CICS attachment facility has detected an 
error. This is the 4-character code that identifies the 
ABEND/DUMP as a CICS attachment facility request for the 
CICS transaction associated with the error. This ABEND/DUMP 
is usually associated with one of the other CICS attachment 
facility X'04E' abends. 


| ~ Internal DB2 Information ~~~ 2 


This code is issued by the following CSECT(s): DSNCEXT1, 
DSNCSTOP 


_——— End of Internal DB2 Information ee 


System Action: The CICS attachment facility processing pro- 
ceeds as defined for the X'04E' system abend associated with 
the dump. If diagnostic information is required and the CICS 
attachment facility determines that the transaction should also 
be abended, EXEC CICS ABEND is issued using DSNC as the 
abend code. Otherwise dump continue, EXEC CICS DUMP, is 
issued with DSNC as the dump code, and a return code is 
placed in the application’s SQLCA. 


User Response: Notify the system programmer. 
Operator Response: Notify the system programmer. 


System Programmer Response: The Problem Determination 
section of this message provides information in addition to the 
information that is related to the associated CICS attachment 
facility abend. Use it to assist you in determining the cause of 
the error. 


Problem Determination: The reason for the error can be deter- 
mined by the codes in the CLOTCFLG field of the CLOT control 
block, included in the dump. Explanations of codes in this field 
are as follows: 


00 Normal, no error. 

04 RCT entry has been corrupted or overlaid. See message 
DSNC044. 

08 Attach Installation error. 


0c Shutdown is in progress. 
10 Abend because of 'no threads available’. 


14 Serious error (system abend X'04E', reason code 
'00C30001'). 


18 The thread subtask has abended; see subtask dump. 
ic Sign-on failed. 
20 Resource is unavailable. 


24 Create thread failed for a reason other than resource 
contention. 


28 Unknown CICS call type. 
2C Indoubt condition lost to CICS cold start. 


30 Unit of recovery (UR) token for resolve indoubt is not in 
the indoubt list. 


34. DB2 UR indoubt is inconsistent—CICS indicates that it 
should not be indoubt. 


38 UR resolution is inconsistent—CICS indicates abort, but 
DB2 indicates commit. 


3C DB2 resolve indoubt failed. 
40 Deadlock; roll back the transaction. 
44 Unknown CICS resource manager call. 


48 TWA size too small for CICS attachment facility 
command processor program (DSNCCOM1). See 
message DSNC047. 


if the thread subtask has abended, a reason code has been put 
into the CLOTWRK‘1 fieid and the abend code put into the 
CLOTWRK2 field. The reason code can also be found in the 
CICS trace table, at TRACE ID X'CO', FIELD B. Refer to Section 
5 of Diagnosis Guide and Reference for information about trace 
facilities. 


Collect the subtask SNAP dump and refer to the reason code 
found in “Section 4. DB2 Codes” on page 4-1. The Problem 
Determination section of some reason codes refers to register 
contents at the time of the abend. The register contents can be 
found in the SNAP dump under RTM2WA SUMMARY. Register 
contents can also be found in the SYS1.LOGREC record. Refer 
to Section 5 of Diagnosis Guide and Reference for examples. 
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Diagnostic Items 


1. 


11. 


12. 
13. 


14. 
15. 
16. 
re 
18. 
19. 
20. 
21. 
22. 
23. 
24. 
25. 
26. 


27. 


Console output from the system on which the 
job was run, and a listing of the SYSLOG data 
set for the period of time spanning the failure. 


. Dynamic dump, taken to SYS1.DUMPxx data 


set, by DB2 (04E/04F abends). 


. SVC dump (or system dump), taken to 


SYS1.DUMPxx data set, as result of an oper- 
ator initiated dump command or SLIP trap exit. 


. SYSABEND, SYSUDUMP, or SYSMDUMP 


output. 


. Listing of SYS1.LOGREC data set, obtained by 


executing IFCEREP1. 


. Listing of DB2 log output. 
. Link pack area map (LPAMAP) and nucleus 


load module map, obtained. by executing 
AMBLIST. 


. Listing of the procs used to initialize DB2 


address spaces. 


. Listing of DSNZPARM module used. 
. IDCAMS LISTCAT output for the ICF (VSAM) 


catalog containing the DB2 subsystem catalog 
that defined the failing index or table. 

VTOC listing of the DASD volume on which the 
failing operation occurred. 

Dump of the index or table space that failed. 
Listing of the results produced by the SQL 
statements. 

Listing of DB2 catalog tables. 

Contents of the BSDS (both copies if dual 
BSDS in use) obtained by using the DB2 Print 
Log Map utility (DSNJU004). 

Source listing of the failing application 
program. 

IRLM trace output. 

Output of the GTF trace (if requested by IBM). 
Listing of the DSNTRACE data set for the DSN 
(TSO attachment facility) session invoived in 
the problem. 

Listing of the ISPF log for the session involved 
in the problem. 

CICS trace listing. 

CICS attach MVS SNAP dump. 

CICS transaction dump. 

IMS trace output. 

IMS dependent region and/or control region 
dump. 

IMS/VS Version 1 system log information, for 
the period of time spanning the failure. 

VVDS dump of the volumes containing the data 
set. 


28. 
29. 


30. 


31. 


32. 


33. 
34. 


35. 
36. 


37. 


38. 


39. 


40. 
41. 


42. 


43. 


44. 


45. 


46. 
47. 


48. 


49. 


50. 
51. 


52. 
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DB2 Repair dump of the requested page. 
DSN1LOGP detail report containing log 
records associated with the damaged page. 
Detailed description of events immediately 
prior to and during the abend. 

SYSPRINT output, including JCL, for the appli- 
cation program or batch job and system mes- 
sages that were issued. 

DB2 log output, including any DB2 Recovery 
Log Archive Tapes. 

DB2 dump of the requested page. 

Definitions of views and tables involved in the 
error. 

Listing of the IRLM procedure. 

Definitions of table spaces, tables, and indexes 
involved in the error. 

Results from SELECT * from 
SYSIBM.SYSDATABASE. 

Use IDCAMS to print from BSDS the record 
with key of X'16000001'. Refer to the /BM 
VSAM Reference. 

DB2 Repair dump of the pages identified in 
DSNIO0141 messages. 

CHECK utility output. 

DB2 Repair dump of the pages identified in 
DSNIO13I messages. 

A copy via (DSN1COPY) of the index space or 
table space identified in the DSNI0131 mes- 
sages on tape. 

DB2 Repair dump of the header page (page 0) 
for each index identified in the DSNI013I mes- 
sages. 

IMS console log. 

UTPRINT output produced by utility invocation 
of SORT. 

Repair dump of all SYSUTIL pages. 

Dump of pageset from DUMP option of 
REPAIR. 

All dumps taken by the attachment facility or 
requesting application. 

Console output from the system on which the 
job was run, and a listing of the MVS SYSLOG 
data set for the period from the last IPL to the 
time of the failure. 

An MVS stand-alone dump. 

Precompiler listing of failing application 
program with SOURCE(YES) and XREF(YES) 
specified. 

Listing of SYSIBM.SYSLGRNG and 
SYSIBM.SYSCOPY. 

X-5 
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53. 
54. 
55. 


56. 


57. 


58. 


59. 


60. 


61. 


62. 


63. 


64. 


65. 


66. 
67. 


68. 


69. 


A copy of the DDITV02 SYSIN data set. 
A copy of the DDOTVO2 output data set. 
The console output and the listing of the 
SYSLOG data set from each connected site for 
the period of time spanning the failure. 
The listings of the SYS1.LOGREC data set, 
obtained by executing IFCEREP1 at each con- 
nected site. 
A listing of the contents of the 
SYSIBM.SYSLUNAMES table at the local DB2 
system and the remote DB2 system. 
A listing of the contents of the 
SYSIBM.SYSUSERNAMES table at the local 
DB2 system and the remote DB2 system. 
Dynamic dump, taken to SYS1.DUMPxx data 
set, by DB2 (04E/04F abends). Availability of 
this dump is dependent upon the failing envi- 
ronment. 
SYSABEND, SYSUDUMP, or SYSMDUMP 
output. Availability of these dumps is 
dependent upon the failing environment. 
A copy (via DSN1COPY) on tape of the page 
set containing the DB2 Directory. Alterna- 
tively, request a dump (produced by the 
REPAIR Utility, DSN1ICOPY or DSN1PRNT) of 
the DBD for each database identified in the 
DSNIO013I messages. Refer to Section 6 of 
Diagnosis Guide and Reference for more infor- 
mation about printing DBDs. 
Listing of SYS1.L.OGREC data set, obtained by 
executing IFCEREP1 and ISDASDAQO. 
A copy of the table and index taken via 
DSN1COPY before any recover is performed. 
Detailed description of events prior to the 
abend such as recovery or other activity 
affecting DSNDB06.SYSDBASE, 
DSNDB01.DSD01, or the subject table spaces. 
Definitions of table spaces, tables, and indexes 
involved in the error. The record identifiers 
(OBIDs) identified with each table in the table 
space with the error can be obtained from 
SYSIBM.SYSTABLES. 
Listing of the entire table space. 
Listing of the DBD, obtained by executing 
UTILITY DIAGNOSE OBD. 
Unformatted DSN1PRNT output of the 
DSNDBO1.DBD01 page set. Use the method 
described in Section 4 of Diagnosis Guide and 
Reference to locate the inconsistent DBD in 
the DSNDB0O1.DBD01 page set. 
The results of the following SQL: 
¢ SELECT * FROM SYSIBM.SYSINDEXES 
WHERE DBID=dbid ORDER BY OBID; 


X-6 DB2 Messages and Codes 


70. 


71. 


72. 


73. 


74. 


75. 


76. 


77. 


78. 


79. 


80. 
81. 


Where dbid is the DBID of the damaged 
DBD. 

e SELECT * FROM SYSIBM.SYSINDEXES 
WHERE DBID=dbid ORDER BY ISOBID; 

e SELECT * FROM SYSIBM.SYSLINKS 
WHERE DBID=dbid ORDER BY OBID; 

e SELECT * FROM SYSIBM.SYSTABLES 
WHERE DBID=dbid ORDER BY OBID; 

e SELECT * FROM 
SYSIBM.SYSTABLESPACE WHERE 
DBID=dbid ORDER BY OBID; 

e SELECT * FROM 
SYSIBM.SYSTABLESPACE WHERE 
DBID = dbid ORDER BY PSID. 


Use the results to compare the information in 
the DB2 Catalog with the DBD. Determine 
which OBDs are inconsistent with the DB2 
Catalog. Use Section 4 of Diagnosis Guide 
and Reference to analyze the DBD. 
DSN1LOGP output with DBID (1) OBID (1F) cov- 
ering the period of time in which the DBD 
inconsistency may have occurred. This period 
of time is roughly from the time of the ABEND 
back to the time when the DB2 Catalog and 
DBD were believed to be consistent. 

A copy of log for this period so that additional 
DSN1LOGP reports can be produced for 
problem determination. 

The location used in the alias entry in 
SYSIBM.SYSTABLES. 

The contents of the SYSIBM.SYSLOCATIONS 
table. 

The AUTHORIZATION ID, PLANNAME, and 
LUNAME of the thread used to select the 
MODENAME in the SYSIBM.SYSMODESELECT 
table. 

The contents of the SYSIBM.SYSLOCATIONS 
table and the SYSIBM.SYSMODESELECT. 
Listing of the contents of 
SYSIBM.SYSLUMODES in the communications 
database. 

System log printout (obtained via MVS 
WRITELOG operator command) showing 
related VSAM/media manager messages that 
may appear there (usually needed only if you 
have a message or reason code that indicates 
a media manager services problem occurred). 
A hexadecimal print of the first record of the 
failing DBRM. 

The listing from the precompile job that gener- 
ated the DBRM. 

Output from the BIND attempt. 

IMS or CICS trace and any dumps. 


Resource Types 


Figure 4. Resource Types 


TYPE Code 


00000100 
00000200 
00000201 

00000202 
00000210 
00000220 
00000230 
00000240 
00000300 
00000301 

00000302 
00000303 

00000400 
00000500 
00000600 
00000700 
00000800 
00000900 
00000901 

00000A00 
00000B00 
00000C00 
00000D00 
00000D01 
00000E00 
00001000 
00001001 

00001002 
00001003 
00001004 
00001005 
A10X 


Where 
AUTHORIZATION 
ID 

BP 

CN 

CR 

DB 

DBP 

DI 

DSN 
FDBK2 

Ic 

IX 
LOCATION 


LU 

TS 
MODE 
MP 


Type of Resource 


Database 

Table space 

Index space 

Table space 
Partition 

Data set 
Temporary file 
Database procedure 
Page 

Index minipage 
Table space page 
Index space page 
ICF catalog 
Storage group 
EDM pool space 
Buffer pool space 
Plan 

32K data area 

Sort storage 

Table 

View 

Index 

DBID/OBID 
DBID/OBiD 

SU limit exceeded 
DDF 

System conversation 
Agent conversation 
CNOS processing 
CDB (Communication database) 
DB access agent 
Alias 


Stands for 
DB2 authorization identifier 


Buffer pool identifier 
Column name 

Creator of the object 
Database name 

Database procedure name 
DBID in decimal of resource 
Data set name 


VTAM secondary return code 


ICF catalog alias name 
Index name 


Location in which the specified 


resource is not available 
Logical unit name 
Table space name 
Logical unit mode name 


Name, Content, and Format 


DB 

DB.SP 
DB.SP 
RD.DB.TS 
DB.SP.PT 
DSN 

SZ 

DBP 
DB.SP.PG 
DB.SP.PG.MP 
DB.SP.PG 
DB.SP.PG 
IC 

SG 


BP 
PL 


RD.CR.TB 

RD.CR.VW 

RD.CR.1X 

RD.DI.O| 

DI.O} 

CN 

LOCATION 
LU.MODE.RTNCD.FDBK2.RCPRI.RCSEC.SENSE 
LU.MODE.RTNCD.FDBK2.RCPRI.RCSEC.SENSE 
LU.MODE.RTNCD.FDBK2.RCPRI.RCSEC.SENSE 
LOCATION.AUTHORIZATION ID.PL 


LOCATION 

RD.CR.AL 
Where Stands for 
Ol OBID in decimal of resource 
PG Hexadecimal page number 
PL Plan identifier 
PT Decimal partition number 
RCPRI APPC primary return code 
RCSEC APPC secondary return code 
RD DB2 release dependency mark 
RTNCD VTAM primary return code 
SENSE SNA sense code 
SG Storage group name 
SP Space name 
SZ Temporary file page size 
TB Table name 
VW View name 


Hexadecimal mini-page number 


X-7 
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Glossary 


The following terms and abbreviations are defined as 
they are used in this book. If you do not find the term 
you are looking for, refer to the index or to the IBM Dic- 
tionary of Computing, SC20-1699. 


abnormal end of task (abend). Termination of a task, a 
job, or a subsystem because of an error condition that 
cannot be resolved during execution by recovery facili- 
ties. 


access path. The path used to get to data specified in 
SQL statements. An access path can involve an index 
or a sequential search. 


active log. The portion of the DB2 log to which log 
records are written as they are generated. The active 
log always contains the most recent log records, 
whereas the archive log holds those records that are 
older and no longer will fit on the active log. 


address space connection. The result of connecting an 
allied address space to DB2. Each address space con- 
taining a task connected to DB2 has exactly one 
address space connection, even though more than one 
task control block (TCB) may be present. See allied 
address space, and task control block. 


agent. A representation within DB2 of a user of DB2 
services. See also allied agent and system agent. 


allied address space. An area of storage external to 
DB2 that is connected to DB2 and is therefore capable of 
requesting DB2 services. 


allied agent. A representation within DB2 of a user of 
DB2 services that exists in an allied address space and 
is connected to DB2. 


ANS. American National Standard 
APF. authorized program facility 


application. A program or set of programs that 
perform a task; for example, a payroll application. 


application plan. The control structure produced 
during the bind process and used by DB2 to process SQL 
statements encountered during application execution. 


archive log. The portion of the DB2 log that contains 
log records that have been moved from the active log 
because they no longer fit. 


attachment facility. An interface between DB2 and TSO, 
IMS, CICS, or batch address spaces. An attachment 
facility allows application programs to access DB2. 


attribute. A characteristic of an entity. For example, in 
database design, the phone number of an employee is 
one of that employee’s attributes. 


authorization ID. A string that can be verified for con- 
nection to DB2 and to which a set of privileges are 
allowed. It may represent an individual, an organiza- 
tional group, or a function, but DB2 does not determine 
this representation. 


AUTOCOMMIT. A SPUFI option that commits the effects 
of SQL statements automatically if they are successfully 
executed. 


backward log recovery. The fourth and final phase of 
restart processing during which DB2 scans the log ina 
backward direction to apply UNDO log records for all 
aborted changes. 


BDS. Basic Device Support 


bind. The process by which the output from the pre- 
compiler is converted to a usable control structure 
called an application plan. Access paths to data are 
selected, and some authorization checking is per- 
formed. 


automatic bind. (More correctly automatic rebind). 
Binding done automatically (without a user issuing 
a BIND command) when an application process 
begins execution and the bound application plan it 
needs is invalid. 


dynamic bind. Binding done dynamically (as the 
SQL statements are entered) when SQL statements 
are prepared through dynamic SQL. 


incremental bind. Binding of an SQL statement 
done during the execution of an application process 
because the statement could not be bound during 
the bind process and VALIDATE(RUN) was specified. 


static bind. Binding of statements which takes 
place after precompilation. All static SQL state- 
ments are prepared for execution at the same time. 
Compare with dynamic bind. 


BMP. Batch Message Processing (iMS/VS) 
bootstrap data set (BSDS). A VSAM data set that con- 
tains name and status information for DB2, as well as 


RBA range specifications, for all active and archive log 
data sets. it also contains passwords for the DB2 direc- 
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tory and catalog, and lists of conditional restart and 
checkpoint records. 


BSAM. Basic Sequential Access Method 

BSDS. bootstrap data set 

buffer pool. Main storage reserved to satisfy the buf- 
fering requirements for one or more table spaces or 
indexes. 

built-in function. Scalar function or column function. 
CAF. call attachment facility 

call attachment facility (CAF). A DB2 attachment 
facility for application programs running in TSO or MVS 
batch. The CAF is an alternative to the DSN command 
processor and thus ajlows greater control over the exe- 
cution environment. 

checkpoint. A point at which DB2 records internal 
status information on the DB2 log that would be used in 
the recovery process if DB2 should abend. 


Cl. contro! interval 


CICS. Represents (in this publication) CICS/OS/VS and 
CICS/MVS 


CICS/MVS. Customer Information Control 
System/Multiple Virtual Storage 


CICS/OS/VS. Customer Information Control 
System/Operating System/Virtual Storage 
CICS attachment facility. A DB2 subcomponent that 
uses the MVS Subsystem Interface (SSI) and cross 
storage linkage to process requests from CICS to DB2 
and to coordinate resource commitment. 


CIDF. control interval definition field 


clause. In SQL, a distinct part of a statement, such as a 
SELECT clause or a WHERE clause. 


CLIST. command list 
CLOSE. Acall attachment facility function that termi- 
nates an MVS task control block’s thread-level con- 


nection with DB2. 


clustering index. An index that determines how rows 
are physically ordered in a table space. 


cold start. A process by which DB2 restarts without 
processing any log records. 
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column. The vertical component of a table. A column 
has a name and a particular data type (for example, 
character, decimal, or integer). 


column function. An SQL operation that derives its 
result from a collection of values across one or more 
rows. See also sca/ar function. 


command. A DB2 operator command or a DSN subcom- 
mand. Distinct from an SQL statement. 


command recognition character (CRC). A character 
that permits an MVS console operator or IMS/VS sub- 
system user to route DB2 commands to specific DB2 
subsystems. 


commit. An operation that terminates a unit of 
recovery. A commit releases all locks. Data that was 
changed is now consistent. 


commit point. A point in time when data is considered 
consistent. 


comparison operator. A symbol (Such as =, >, <) 
used to check a relationship between two values. 


concurrency. The shared use of resources by multiple 
application processes at the same time. 


conditional restart. A DB2 restart that is directed by a 
user-defined conditional restart control record (CRCR). 


CONNECT. Acall attachment facility function that 
establishes an MVS task control block’s initial con- 
nection to DB2. 


connection ID. An identifier supplied by the attach- 
ment facility that is associated with a specific address 
space connection. 


coordinator. The entity that determines whether a 
commit process is to complete or roll back. See also 
participant. 


correlated subquery. A subquery (part of a WHERE or 
HAVING clause) applied to a row or group of rows of a 
table or view named in an outer Sub-SELECT statement. 


correlation ID. An identifier associated with a specific 
thread. In TSO, itis either your authorization ID or the 
job name. 


correlation name. An identifier that designates a table, 
a view, or individual rows of a table or view within a 
single SQL statement. It can be defined in any FROM 
clause or in the first clause of an UPDATE or DELETE 
statement. 


CRC. command recognition character 


CRCR. conditional restart control record 


CSA. MVS common service area 


cursor. A named control structure used by an applica- 
tion program to point to a row of interest within some 
set of rows, and to retrieve rows from the set, possibly 
making updates or deletions. 


cursor stability. The isolation level that provides 
maximum concurrency. With cursor stability, a unit of 
work holds locks only on its uncommitted changes and 
the current row of each of its cursors. 


database. A collection of tables, or a collection of 
table spaces and index spaces. 


database administrator (DBA). An individual respon- 
sible for the design, development, operation, safe- 
guarding, maintenance, and use of a database. 


database descriptor (DBD). An internal representation 
of DB2 database definition which reflects the data defi- 
nition found in the DB2 catalog. The objects defined ina 
database descriptor are table spaces, tables, indexes, 
index spaces, and relationships. 


database request module (DBRM). A data set member 
created by the DB2 precompiier that contains informa- 
tion about SQL statements. DBRMs are used in the bind 
process. 


data type. An attribute of columns, literals, and host 
variables. 


date. A three-part value that designates a day, month, 
and year. 


date duration. A decimal integer that represents a 
number of years, months, and days. 


DBA. database administrator 

DBD. database descriptor 

DBMS. database management system 

DBRM. database request module 

DB2 catalog. DB2-maintained tables that contain 
descriptions of DB2 objects such as tables, views, and 
indexes. 

DB2 Interactive (DB2!). The DB2 facility that provides 
for the execution of SQL statements, DB2 (operator) 
commands, programmer commands, and utility invoca- 
tion. 

DB2I. DATABASE 2 Interactive 


DCB. data. control block 


DCLGEN. declarations generator 


DDL. data definition language 


declarations generator (DCLGEN). A subcomponent of 
DB2 that generates SQL table declarations and COBOL, 
C, or PL/I data structure declarations that conform to 
the table. The declarations are generated from DB2 
system catalog information. DCLGEN is also a DSN sub- 
command. 


DFP. Data Facility Product 


DISCONNECT. Acall attachment facility function that 
terminates an MVS task contro! block’s connection to 
DB2. 


DSN. (1) The default DB2 subsystem name. (2) The 
name of DB2’s TSO command processor. (3) The first 
three characters of DB2 module and macro names. 


DSN command processor. The DB2 component that 
processes DB2 subcommands (such as BIND, RUN, etc). 


duration. A number that represents an interval of time. 
See labeled duration, date duration, and time duration. 


DXT. Data Extract 


dynamic SQL. SQL statements that are prepared and 
executed within an application program while the 
program is executing. In dynamic SQL, the SQL source 
is contained in host language variables rather than 
being coded into the application program. The SQL 
statement might change several times during the appli- 
cation program’s execution. 


EBCDIC. extended binary coded decimal! interchange 
code 


embedded SQL. SQL statements that are embedded 
within an application program and are prepared during 
the program preparation process before the program is 
executed. After it is prepared, the statement itself does 
not change (although values of host variables specified 
within the statement might change). 


ESDS. entry sequenced data set 
ESMT. external subsystem module table (IMS/VS) 
EUR. IBM European Standards 


execution unit. An MVS dispatchable unit of program 
execution, (either a TCB or an SRB). 


execution unit switch. A DB2-specific mechanism for 
switching thread execution between TCBs and/or SRBs. 


exit routine. A user-written (or IBM-provided default) 


program that receives control from DB2 to perform spe- 
cific functions. Exit routines run as extensions of DB2 
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explicit connection. The mode of connecting a task to 
DB2 in which the application program takes explicit 
control over the state of the connection. An explicitly 
connected task uses some or all of the CAF functions: 
CONNECT, DISCONNECT, OPEN, and CLOSE. See address 
space connection and implicit connection. 


expression. An operand or a collection of operators 
and operands that yields a single value. 


fall back. The process of returning to previous 
releases of DB2 after attempting or completing 
migration to a current release. 


forward log recovery. The third phase of restart proc- 
essing during which DB2 processes the log in a forward 
direction to apply all REDO log records. 


function. A scalar function or column function. Same 
as built-in function. 


GMT. Greenwich Mean Time 
governor. See resource limit facility. 
GTF. generalized trace facility 


host program. An application program written ina 
host language that contains embedded SQL statements. 


host structure. In an application program, a structure 
referenced by embedded SQL statements. 


host variable. In an application program, an applica- 
tion variable referenced by embedded SQL statements. 


ICF. integrated catalog facility 


identify. A request that an attachment service program 
in an address space separate from DB2 issues via the 
MVS subsystem interface to inform DB2 of its existence 
and initiate the process of becoming connected to DB2. 


image copy. An exact reproduction of all or part of a 
table space. DB2 provides utility programs to make full 
image copies (to copy the entire table space) or incre- 
mental image copies (to copy only those pages that 
have been modified since the last image copy). 


implicit connection. The mode of connecting a task to 
DB2 in which the attachment facility manages the con- 
nection. See explicit connection. 


IMS attachment facility. A DB2 subcomponent that uses 
MVS Subsystem Interface (SSI) protocols and cross- 
memory linkage to process requests from IMS to DB2 
and to coordinate resource commitment. 


IMS Resource Lock Manager (IRLM). An MVS sub- 


system used by DB2 to contro! communication and data- 
base locking. 
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IMS/VS. Information Management System/Virtual 
Storage 


index. A set of pointers that are logically ordered by 
the values of a key. Indexes can provide faster access 
to data and can enforce uniqueness on the rows ina 
table. 


index key. The set of columns in a table used to deter- 
mine the order of index entries. 


index space. A page set used to store the entries of 
one index. 


indicator variable. A variable used to represent the 
null value in an application program. If the value for 
the selected column is null, a negative value is placed 
in the indicator variable. 


indoubt. A status of a unit of recovery. If DB2 fails 
after it has finished its phase 1 commit processing and 
before it has started phase 2, only the commit coordi- 
nator knows if this unit of recovery is to be committed 
or rolled back. At emergency restart, if DB2 does not 
have the information needed to make this decision, its 
unit of recovery is indoubt until DB2 obtains this infor- 
mation from the coordinator. 


install. The process of preparing a DB2 subsystem to 
operate as an MVS subsystem. 


IRLM. IMS/VS Resource Lock Manager 

ISO. International Standards Organization 

isolation level. The degree to which a unit of work is 
isolated from the updating operations of other units of 
work. See also cursor stability and repeatable read. . 


ISPF. Interactive System Productivity Facility 


ISPF/PDF. interactive System Productivity 
Facility/Program Development Facility 


JCL. job control language 

JIS. Japanese Industrial Standard 

join. A relational operation that allows retrieval of 
data from two or more tables based on matching 
column values. 

JWT. job wait time 

K. kilobyte (1024 bytes) 

KSDS. key sequenced data set 

labeled duration. A number that represents a duration 


of years, months, days, hours, minutes, seconds, or 
microseconds. 


latch. A DB2 internal mechanism for serializing events 
or the use of system resources. 


LCID. log contro} interval definition 


lock. A means of serializing events or access to data. 
DB2 locking is performed by the IRLM. 


locking. The process by which integrity of data is 
ensured. Locking prevents concurrent users from 
accessing inconsistent data. 


log initialization. The first phase of restart processing 
during which DB2 attempts to locate the current end of 
the log. 


log truncation. A process by which an explicit starting 
RBA is established; this RBA is the point at which the 
next byte of log data will be written. 


LRH. log record header 


migration. The process of converting a DB2 subsystem 
with a previous release of DB2 to an updated or current 
release. It allows you to acquire the functions of the 
updated or current release without losing the data you 
created on the previous release. 


MPP. message processing program (IMS/VS) 
MVS. Multiple Virtual Storage 
NRE. network recovery element 


null. A special value that indicates the absence of 
information. 


object. Anything that can be created or manipulated 
with SQL—that is, databases, table spaces, tables, 
views, or indexes. 


OPEN. (1) Acall attachment facility function that estab- 
lishes an MVS task control block’s thread-level con- 
nection with DB2. (2) OPEN CURSOR. 


optimizer. The DB2 component that processes SQL 
statements and selects access paths. 


page. A unit of storage within a table space (4K or 32K) 
or index space (4K). In a table space, a page contains 
one or more rows of a table. 


page set. A tablespace or indexspace either 4K or 32K 
in size. Each page is made from a collection of VSAM 
data sets. 


page set piece. One of the data sets that make up a 
page set. Usually used when referring to data sets. 
associated with a simple page set, but can sometimes 
refer to the data set corresponding to a partition of a 
partitioned page set. 


partitioned table space. A table space subdivided into 
parts (based upon index key range), each of which may 
be processed by utilities independently. 


PCT. program control table (CICS) 

PDS. partitioned data set 

PHB. pool header block 

plan. See application plan. 

plan name. The name of an application plan. 


PPT. (1) processing program table (CICS) (2) program 
properties table (MVS) 


precompilation. A processing of application programs 
containing SQL statements that takes place before com- 
pilation. SQL statements are replaced with statements 
that will be recognized by the host language compiler. 
Output from this precompilation includes source code 
that can be submitted to the compiler and the database 
request module (DBRM) that is input to the bind 
process. 


predicate. An element of a search condition that 
expresses or implies a comparison operation. 


preformat. The process of preparing a VSAM ESDS for 
DB2 use, by writing specific data patterns. 


privilege. The capability of performing a specific func- 
tion, sometimes on a specific object. The term 
includes: 


Explicit privileges: These have names and are 
held as the result of SQL GRANT and REVOKE state- 
ments; for example, the SELECT privilege. 


Implicit privileges: These accompany the owner- 
ship of an object, such as the privilege to drop a 
synonym one owns, or the holding of an authority, 
such as the privilege of SYSADM authority to termi- 
nate any utility job. 

QMF. Query Management Facility 

RACF. OS/VS2 MVS Resource Access Control Facility 

RBA. relative byte address 

RCT. resource control table (CICS attachment facility) 


RDF. record definition field 


recovery. The process of rebuilding databases after a 
system failure. 


recovery log. Acoliection of records that describes 
the events that occur during DB2 execution and their 
sequence. The information recorded is used for 
recovery in the event of a failure during DB2 execution. 
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redo. A state of a unit of recovery which indicates that 
changes made are to be reapplied to the DASD media to 
ensure data integrity. 


relative byte address (RBA). The offset of a data 
record or contro! interval from the beginning of the 
storage space allocated to the data set or file to which 
it belongs. 


remigration. The process of returning to a current 
release of DB2 following a fall back to a previous 
release. This procedure constitutes another migration 
process. 


repeatable read. The isolation level that provides 
maximum protection from other executing application 
programs. When an application program executes with 
repeatable read protection, rows referenced by the 
program cannot be changed by other programs until 
the program reaches a commit point. 


result table. The set of rows specified by a SELECT 
statement. 


RO. read-only access 


roliback. An operation that reverses all the changes 
made during the current unit of recovery. After the 
operation is complete, a new unit of recovery begins. 


row. The horizontal component of a table. A row con- 
sists of a sequence of values, one for each column of 
the tabie. 


RTT. resource translation table 


scalar function. An SQL operation that produces a 
single value from another value and is expressed as a 
function name followed by a list of arguments enclosed 
in parentheses. See also column function. 


search condition. A criterion for selecting rows from a 
table. A search condition consists of one or more pred- 
icates. 


service task. A task created in the systems services 
and database services address spaces during DB2 
initialization and switched to by means of the execution 
unit switch mechanism as its services are required. 


sign-on. A request made on behalf of an individual 
CICS or IMS/VS application process by an attach facility 
to enable DB2 to verify that it is authorized to use DB2 
resources. 


simple page set. A nonpartitioned page set. A simple 
page Set initially consists of a single data set (page set 
piece). If and when that data set is extended to 2 
gigabytes, another data set is created, and so on up to 
a total of 32 data sets. The data sets are considered by 
DB2 to be a single contiguous linear address space con- 
taining a maximum of 64 gigabytes. Data is stored in 
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the next available location within this address space 
without regard to any partitioning scheme. 


SMF. system management facility 
SMP. System Modification Program 
SNT. sign-on table 


SPUFI. SQL Processor Using File Input. A facility of 
the TSO attachment subcomponent that enables the DBa2! 
user to execute SQL statements without embedding 
them in an application program. 


SQL. Structured Query Language. A language that 
can be used within host programming languages, or 
interactively, to define and manipulate data and to 
control access to resources. 


SQL Communication Area (SQLCA). A structure used 
to provide an application program with information 
about the execution of its SQL statements. 


SQL Descriptor Area (SQLDA). A structure that 
describes input variables, output variables, or the 
columns of a result table used in the execution of 
manipulative SQL statements. 

SQL/DS. SQL/Data System 

SQLCA. SQL communication area 

SQLDA. SQL descriptor area 

SSI. MVS subsystem interface 

stand-alone. An attribute of a program that means it is 
capable of executing separately from DB2, without using 


DB2 services. 


storage group. A named set of DASD volumes on which 
DB2 data can be stored. 


subcomponent. A group of closely related DB2 
modules that work together to provide a general func- 
tion. 


subpage. The unit into which a physical index page 
can be divided. 


subquery. A SELECT statement within the WHERE or 
HAVING clause of another SQL statement; a nested SQL 
statement. 


subselect. That form of the SELECT statement that does 
not include ORDER BY or UNION operators. 


sync point. See commit point. 


synonym. In SQL, an alternative name for a table or 
view. 


system administrator. The person having the second 
highest level of authority within DB2. System adminis- 
trators make decisions about how DB2 is to be used and 
implement those decisions by choosing system param- 
eters. They monitor the system and change its charac- 
teristics to meet changing requirements and new data 
processing goals. 


system agent. An agent that is created for DB2 internal 
use. See also agent. 


system diagnostic work area (SDWA). The data that is 
recorded in a SYS1.LOGREC entry that describes a 
program or hardware error. 


table. A named data object consisting of a specific 
number of columns and some number of unordered 
rows. 


table space. A page set used to store the records of 
one or more tables. 


TCB. MVS task control block 


thread. The DB2 structure that describes an applica- 
tion’s connection, traces its progress, provides 
resource function processing capability, and delimits 
its accessibility to DB2 resources and services. Most 
DB2 functions execute under a thread structure. See 
also allied threads and database access thread. 


time. A three-part value that designates a time of day 
in hours, minutes, and seconds. 


time duration. A decimal integer that represents a 
number of hours, minutes, and seconds. 


timestamp. A seven-part value that consists of a date 
and time expressed in years, months, days, hours, 
minutes, seconds, and microseconds. 


to-do. A state of a unit of recovery that indicates that 
the unit of recovery’s changes to recoverable DB2 
resources are indoubt and must either be applied to the 
DASD media or backed out, as determined by the 
commit coordinator. 


TSO. Time Sharing Option. Provides interactive time 
sharing from remote terminals. A subsystem of MVS. 
Also represents (in this publication) TSO/E. 


TSO attachment facility. A DB2 facility consisting of the 
DSN command processor and DB2!. Applications that 
are not written for the CICS or IMS environments can run 
under the TSO attachment facility. 


undo. A state of a unit of recovery that indicates that 
the changes made by the unit of recovery to recover- 
able DB2 resources must be backed out. 


UNION. An SQL operation that combines the results of 
two select statements. UNION is often used to merge 
lists of values obtained from several tabies. 


unique index. An index which ensures that no identical 
key values are stored in a table. 


unit of recovery (UR). A recoverabie sequence of 
operations within an application process. At any time, 
an application process is a single unit of recovery, but 
the life of an application process may involve many 
units of recovery as a result of commit or rollback oper- 
ations. 


unlock. To release an object or system resource that 
was previously locked and return it to general avail- 
ability within DB2. 

UR. unit of recovery 

URE. unit of recovery element 

URID (unit of recovery ID). The LOGRBA of the first log 
record for a unit of recovery. The URID also appears in 
all subsequent log records for that unit of recovery. 
UT. utility-only access 

value. The smallest unit of data manipulated in SQL. 
view. An alternative representation of data from one 
or more tables. A view can include all or some of the 


columns contained in table(s) on which it is defined. 


VSAM. Virtual Storage Access Method 
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